Changeset 52d29f7 for general/prog


Ignore:
Timestamp:
06/12/2004 10:56:28 PM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
d3edf27
Parents:
bfe245f
Message:

XML Updates to Part III from DJ

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2304 af4574ff-66df-0310-9fd7-8a98e5e911e0

Location:
general/prog
Files:
11 edited

Legend:

Unmodified
Added
Removed

  • general/prog/gcc.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY gcc-download-http  "http://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
     8  <!ENTITY gcc-download-ftp   "ftp://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
     9  <!ENTITY gcc-size           "23 MB">
     10  <!ENTITY gcc-buildsize      "889 MB">
     11  <!ENTITY gcc-time           "29.3 SBU">
     12 
     13  <!ENTITY gnat-download-http " ">
     14  <!ENTITY gnat-download-ftp  "ftp://cs.nyu.edu/pub/gnat/3.15p/gnat-3.15p-i686-pc-redhat71-gnu-bin.tar.gz">
     15  <!ENTITY gnat-size          "13.2 MB">
     16  <!ENTITY gnat-buildsize     "48.9 MB">
     17  <!ENTITY gnat-time          "0.01 SBU">
     18]>
     19
    120<sect1 id="gcc" xreflabel="GCC-&gcc-version;">
    221<?dbhtml filename="gcc.html" ?>
    322<title>GCC-&gcc-version;</title>
    423
    5 &gcc-intro;
    6 &gcc-inst;
    7 &gcc-exp;
    8 &gcc-desc;
     24<sect2>
     25<title>Introduction to <application><acronym>GCC</acronym></application></title>
     26                                                                               
     27<para>The  <application><acronym>GCC</acronym></application> package
     28contains <acronym>GNU</acronym> compilers. This is useful for
     29compiling programs written in <application>Ada</application>,
     30<application>C</application>, <application>C++</application>,
     31<application>Fortran</application>, <application>Java</application> and
     32<application>Objective C</application>.</para>
     33                                                                               
     34<sect3><title>Package information</title>
     35<itemizedlist spacing='compact'>
     36<listitem><para>Download (HTTP): <ulink
     37url="&gcc-download-http;"/></para></listitem>
     38<listitem><para>Download (FTP): <ulink
     39url="&gcc-download-ftp;"/></para></listitem>
     40<listitem><para>Download size: &gcc-size;</para></listitem>
     41<listitem><para>Estimated Disk space required:
     42&gcc-buildsize;</para></listitem>
     43<listitem><para>Estimated build time:
     44&gcc-time;</para></listitem></itemizedlist>
     45</sect3>
     46<sect3><title>Additional Downloads</title>
     47<itemizedlist spacing='compact'>
     48<listitem><para>Required patch: <ulink url="&patch-root;/gcc-&gcc-version;-no_fixincludes-1.patch"/></para></listitem>
     49</itemizedlist></sect3>
     50                                                                               
     51</sect2>
     52
     53<sect2>
     54<title>Installation of <application><acronym>GCC</acronym></application></title>
     55                                                                               
     56<para>If you plan to compile Ada, you will need to install
     57<application><acronym>GNAT</acronym></application> temporarily to
     58satisfy the circular dependency when you recompile
     59<application><acronym>
     60GCC</acronym></application> to include
     61<application>Ada</application>.</para>
     62
     63<sect3><title>Package information</title>
     64<itemizedlist spacing='compact'>
     65<listitem><para>Download (HTTP): <ulink
     66url="&gnat-download-http;"/></para></listitem>
     67<listitem><para>Download (FTP): <ulink
     68url="&gnat-download-ftp;"/></para></listitem>
     69<listitem><para>Download size: &gnat-size;</para></listitem>
     70<listitem><para>Estimated Disk space required:
     71&gnat-buildsize;</para></listitem>
     72<listitem><para>Estimated build time:
     73&gnat-time;</para></listitem></itemizedlist>
     74</sect3>
     75
     76<sect3><title><application><acronym>GNAT</acronym></application> dependencies</title>
     77<sect4><title>Required</title>
     78<para><xref linkend="tcsh"/></para></sect4>
     79</sect3>
     80
     81</sect2>
     82                                                                               
     83<sect2>
     84<title>Installation of <application><acronym>GNAT</acronym></application></title>
     85
     86<para>Install <application><acronym>GNAT</acronym></application> by running the
     87following commands:</para>
     88
     89<screen><userinput><command>./doconfig</command></userinput></screen>
     90
     91<para>The above script will ask you how and where you would like to install
     92<application><acronym>GNAT</acronym></application>. To avoid conflicts with the
     93system <command>gcc</command>, the package will be installed in a separate
     94directory, that can later be removed from the system.</para>
     95
     96<para>In response to the questions asked by the
     97<command>doconfig</command> script, enter
     98<userinput>3</userinput> in response to the first question
     99and <userinput>/opt/gnat</userinput> in response to the
     100second question.</para>
     101
     102<para>To finish the install, run:</para>
     103<screen><userinput><command>./doinstall</command></userinput></screen>
     104
     105<para>The <application><acronym>GNAT</acronym></application> compiler can be
     106invoked by executing the <command>gcc</command> binary installed by the above
     107script.</para>
     108
     109</sect2>
     110
     111                                                                               
     112<sect2><title>Return to Installation of <application><acronym>GCC</acronym></application></title>
     113                                                                               
     114<para>Patch the source files with the following command:</para>
     115<screen><userinput><command>patch -Np1 -i ../gcc-&gcc-version;-no_fixincludes-1.patch &amp;&amp;
     116sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</command></userinput></screen>
     117                                                                               
     118<para>Install <application><acronym>GCC</acronym></application> by running the
     119following commands:</para>
     120                                                                               
     121<screen><userinput><command>PATH_HOLD=$PATH &amp;&amp;
     122export PATH=/opt/gnat/bin:$PATH &amp;&amp;
     123cd gcc/ada &amp;&amp;
     124touch treeprs.ads [es]info.h nmake.ad[bs] &amp;&amp;
     125cd ../.. &amp;&amp;
     126mkdir ../gcc-build &amp;&amp;
     127cd ../gcc-build &amp;&amp;
     128CC=/usr/bin/gcc ../gcc-&gcc-version;/configure --prefix=/usr --enable-shared \
     129    --enable-languages=c,c++,objc,f77,ada,java --enable-threads=posix \
     130    --enable-__cxa_atexit --enable-clocale=gnu &amp;&amp;
     131make bootstrap &amp;&amp;
     132make -C gcc gnatlib_and_tools &amp;&amp;
     133make -k check &amp;&amp;
     134make install &amp;&amp;
     135ln -sf ../usr/bin/cpp /lib &amp;&amp;
     136ln -sf gcc /usr/bin/cc &amp;&amp;
     137ln -sf g77 /usr/bin/f77 &amp;&amp;
     138export PATH=$PATH_HOLD</command></userinput></screen>
     139                                                                               
     140<para>You may remove the <application><acronym>GNAT</acronym></application>
     141installation:</para>
     142<screen><userinput><command>rm -rf /opt/gnat</command></userinput></screen>
     143                                                                               
     144</sect2>
     145
     146<sect2>
     147<title>Command explanations</title>
     148                                                                               
     149<para><command>PATH_HOLD=$PATH</command>: This command
     150stores your current path before it's modified so that it can be restored after
     151installation.</para>
     152                                                                               
     153<para><command>export PATH=/opt/gnat/bin:$PATH</command>: This
     154command allows the build to find
     155<application><acronym>GNAT</acronym></application>'s
     156<application>Ada</application> compiler to build
     157<application>Ada</application>.</para>
     158                                                                               
     159<para><command>touch treeprs.ads [es]info.h nmake.ad[bs]</command>:
     160This command creates necessary files for the
     161<application>Ada</application> build. This step
     162may be skipped if you don't want to compile the
     163<application>Ada</application> front end.</para>
     164                                                                               
     165<para><parameter>CC=/usr/bin/gcc</parameter>: This command works around the
     166new <envar>PATH</envar> which puts <application><acronym>GNAT</acronym>
     167</application>'s <command>gcc</command> as the primary compiler.</para>
     168                                                                               
     169<para><parameter>--enable-languages=c,c++,objc,f77,ada,java</parameter>: This command builds all available languages in the
     170<application><acronym>GCC</acronym></application> package.
     171You may modify this command to remove unwanted languages.</para>
     172                                                                               
     173<para><parameter>--enable-shared --enable-threads=posix
     174--enable-__cxa_atexit</parameter>: These commands are required to build
     175the <application>C++</application> libraries to published standards.</para>
     176                                                                               
     177<para><parameter>--enable-clocale=gnu</parameter>: This command is a
     178failsafe for incomplete locale data.</para>
     179                                                                               
     180<para><command>make gnatlib_and tools</command>: This command
     181completes the <application>Ada</application> build process. Skip this step if
     182you have not enabled <application>Ada</application> as one of the languages.
     183</para>
     184                                                                               
     185</sect2>
     186
     187<sect2>
     188<title>Contents</title>
     189                                                                               
     190<para>The <application><acronym>GCC</acronym></application> package contains
     191<command>c++</command>,
     192<command>c++filt</command>, <command>cpp</command>,
     193<command>g++</command>, <command>g77</command>,
     194<command>gcc</command>, <command>gccbug</command>,
     195<command>gcov</command>, <command>glob</command>,
     196<command>gnat</command>, <command>gnatbind</command>,
     197<command>gnatbl</command>, <command>gnatchop</command>,
     198<command>gnatfind</command>, <command>gnatkr</command>,
     199<command>gnatlink</command>, <command>gnatls</command>,
     200<command>gnatmake</command>, <command>gnatprep</command>,
     201<command>gnatpsta</command>, <command>gnatpsys</command>,
     202<command>gnatxref</command> and
     203<application><acronym>GCC</acronym></application> libraries.</para>
     204                                                                               
     205</sect2>
     206                                                                               
     207<sect2><title>Description</title>
     208                                                                               
     209<para>The programs and libraries whose descriptions are missing here
     210have been described in the <acronym>LFS</acronym>
     211<acronym>GCC</acronym>-&gcc-version; page.</para>
     212                                                                               
     213<sect3><title>g77</title>
     214<para><command>g77</command> is the <application>Fortran</application> compiler                                                                               
     215invoked by <command>gcc</command>.</para></sect3>
     216                                                                               
     217<sect3><title>add2line</title>
     218<para><command>add2line</command> converts the <acronym>ASCII</acronym> form of                                                                               
     219the 2-line orbital elements in a file to binary form and appends them to the
     220orbdata files. </para></sect3>
     221                                                                               
     222<sect3><title>gcov</title>
     223<para><command>gcov</command> is a test coverage program.</para></sect3>
     224                                                                               
     225<sect3><title>gdb</title>
     226<para><command>gdb</command> is the
     227<application><acronym>GNAT</acronym></application> debugger.</para></sect3>
     228                                                                               
     229<sect3><title>gnatbind</title>
     230<para><command>gnatbind</command> is used to bind compiled objects.</para>
     231</sect3>
     232                                                                               
     233<sect3><title>gnatbl</title>
     234<para><command>gnatbl</command> is the <application>Ada</application> linker.
     235</para></sect3>
     236                                                                               
     237<sect3><title>gnatchop</title>
     238<para><command>gnatchop</command> is useful for renaming files to meet the
     239standard <application>Ada</application> default file naming conventions.</para></sect3>
     240                                                                               
     241<sect3><title>gnatelim</title>
     242<para><command>gnatelim</command> is used to detect and eliminate unused
     243subprograms in an <application>Ada</application> partition.</para></sect3>
     244                                                                               
     245<sect3><title>gnatfind</title>
     246<para><command>gnatfind</command> is the <application><acronym>GNAT</acronym>
     247</application> definition/use finder.</para></sect3>
     248                                                                               
     249<sect3><title>gnatgcc</title>
     250<para><command>gnatgcc</command> is the compiler.</para></sect3>
     251                                                                               
     252<sect3><title>gnathtml.pl</title>
     253<para><command>gnathtml.pl</command> converts
     254<application>Ada</application> source files to <acronym>HTML</acronym> for
     255viewing in Web browsers.</para></sect3>
     256                                                                               
     257<sect3><title>gnatkr</title>
     258<para><command>gnatkr</command> is used to determine the crunched name for a
     259given file, when crunched to a specified maximum length.</para></sect3>
     260                                                                               
     261<sect3><title>gnatlink</title>
     262<para><command>gnatlink</command> is used to link programs and build an
     263executable file.</para></sect3>
     264                                                                               
     265<sect3><title>gnatls</title>
     266<para><command>gnatls</command> is the compiled unit browser.</para></sect3>
     267                                                                               
     268<sect3><title>gnatemake</title>
     269<para><command>gnatmake</command> is an automatic make facility.</para></sect3>                                                                               
     270<sect3><title>gnatmem</title>
     271<para><command>gnatmem</command> is the <application><acronym>GNAT</acronym>
     272</application> utility that monitors dynamic allocation and
     273deallocation activity in a program.</para></sect3>
     274                                                                               
     275<sect3><title>gnatprep</title>
     276<para><command>gnatprep</command> is the
     277<application><acronym>GNAT</acronym></application> external preprocessor.</para>
     278</sect3>
     279                                                                               
     280<sect3><title>gnatpsta</title>
     281<para><command>gnatpsta</command> determines the values of all the relevant
     282parameters in Standard and outputs to stdout.</para></sect3>
     283                                                                               
     284<sect3><title>gnatpsys</title>
     285<para><command>gnatpsys</command> determines the values of all the relevant
     286parameters in System and outputs to stdout.</para></sect3>
     287
     288<sect3><title>gnatstub</title>
     289<para><command>gnatstub</command> is a generator of body stubs.</para></sect3>
     290                                                                               
     291<sect3><title>gnatxref</title>
     292<para><command>gnatxref</command> is the <application><acronym>GNAT</acronym></application> cross-referencer.</para></sect3>
     293                                                                               
     294<sect3><title>gvd</title>
     295<para><command>gvd</command> is the <acronym>GNU</acronym> Visual Debugger.
     296</para></sect3>
     297                                                                               
     298</sect2>
    9299
    10300</sect1>

  • general/prog/gcc2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY gcc2-download-http "http://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
     8  <!ENTITY gcc2-download-ftp  "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
     9  <!ENTITY gcc2-size          "9.4 MB">
     10  <!ENTITY gcc2-buildsize     "150 MB">
     11  <!ENTITY gcc2-time          "2.60 SBU">
     12]>
     13
    114<sect1 id="gcc2" xreflabel="GCC-&gcc2-version;">
    215<?dbhtml filename="gcc2.html" ?>
    316<title>GCC-&gcc2-version;</title>
    417
    5 &gcc2-intro;
    6 &gcc2-inst;
    7 &gcc2-config;
    8 &gcc2-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>GCC</acronym></application>-&gcc2-version;</title>
     20                                                                               
     21                                                                               
     22<para>There are two reasons for installing
     23<acronym>GCC</acronym>-&gcc2-version;. The first is that the kernel
     24developers have certified <acronym>GCC</acronym>-&gcc2-version; as the
     25preferred compiler for compiling the kernel. The other (and more compelling
     26reason) is that some commercial closed-source packages (such as Netscape
     27Navigator, Yahoo Pager) and precompiled packages (such as Mozilla)
     28are linked against <acronym>GCC</acronym>-&gcc2-version; libs.</para>
     29                                                                               
     30<sect3><title>Package information</title>
     31<itemizedlist spacing='compact'>
     32<listitem><para>Download (HTTP): <ulink
     33url="&gcc2-download-http;"/></para></listitem>
     34<listitem><para>Download (FTP): <ulink
     35url="&gcc2-download-ftp;"/></para></listitem>
     36<listitem><para>Download size: &gcc2-size;</para></listitem>
     37<listitem><para>Estimated Disk space required:
     38&gcc2-buildsize;</para></listitem>
     39<listitem><para>Estimated build time:
     40&gcc2-time;</para></listitem></itemizedlist>
     41</sect3>
     42                                                                               
     43<sect3><title>Additional downloads</title>
     44<itemizedlist spacing='compact'>
     45<listitem><para><ulink url="&patch-root;/gcc-2.95.3-2.patch"/></para></listitem>
     46<listitem><para><ulink url="&patch-root;/gcc-2.95.3-no-fixinc.patch"/></para></listitem>
     47<listitem><para><ulink url="&patch-root;/gcc-2.95.3-returntype-fix.patch"/></para></listitem>
     48</itemizedlist>
     49</sect3>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Configuring <application><acronym>GCC</acronym></application></title>
     55                                                                               
     56<sect3><title>Configuration Information</title>
     57                                                                               
     58<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/> 
     59                                                                               
     60<para>The instructions given above make compatibility symlinks that pre-compiled
     61packages in <acronym>BLFS</acronym> require. You may create additional
     62compatibility links based on your requirements.</para>
     63                                                                               
     64<para>If you only need the GCC-&gcc2-version; libraries, you may delete
     65<filename>/opt/gcc-&gcc2-version;</filename>.</para>
     66                                                                               
     67<para>Whenever you need to use GCC-&gcc2-version; instead of your system
     68installed compiler, add
     69<filename class="directory">/opt/gcc-&gcc2-version;/bin</filename> to the front of your <envar>PATH</envar> or (preferably) set the <envar>CC</envar>
     70environment variable before compiling the concerned package.</para>
     71                                                                               
     72</sect3>
     73                                                                               
     74</sect2>
     75
     76<sect2>
     77<title>Contents</title>
     78                                                                               
     79<para>The GCC-&gcc2-version; package contains the
     80<command>gcc</command>-&gcc2-version; <application>C</application> and
     81<application>C++</application> compilers and GCC-&gcc2-version;
     82<filename>libstdc++.so</filename> that is required by some commercial and
     83pre-compiled packages.</para>
     84                                                                               
     85</sect2>
    986
    1087</sect1>

  • general/prog/j2sdk.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY j2sdk-download-http "http://freshmeat.net/projects/sunjdk">
     8  <!ENTITY j2sdk-download-ftp  " ">
     9  <!ENTITY j2sdk-bin-size      "35 MB">
     10  <!ENTITY j2sdk-src-size      "77 MB">
     11  <!ENTITY j2sdk-src-buildsize "1810 MB">
     12  <!ENTITY j2sdk-time          "85 SBU">
     13]>
     14
    115<sect1 id="j2sdk" xreflabel="J2SDK-&j2sdk-src-version;">
    216<?dbhtml filename="j2sdk.html" ?>
    317<title>J2SDK-&j2sdk-src-version;</title>
    418
    5 &j2sdk-intro;
    6 &j2sdk-inst;
    7 &j2sdk-exp;
    8 &j2sdk-config;
    9 &j2sdk-desc;
     19<sect2>
     20<title>Introduction to j2sdk</title>
     21                                                                               
     22<para>The <application>J2SDK</application> package contains Sun's
     23<application>Java</application> development environment. This is useful for
     24developing <application>Java</application> programs and provides the runtime
     25environment necessary to run <application>Java</application> programs.  It also                                                                               
     26includes a plug-in for browsers so that they can be <application>Java
     27</application> aware.</para>
     28                                                                               
     29<para>
     30The <acronym>JDK</acronym> comes in two flavors, a precompiled binary and a
     31source package. Previously, the plugin included in the <acronym>JDK</acronym> binary
     32package was unusable on <acronym>LFS</acronym>
     33owing to incompatibilities with <acronym>GCC</acronym>-3 compiled browsers.
     34This is not the case anymore.</para>
     35                                                                               
     36<para>The source package requires registration at the Sun
     37developer site and accepting the Sun Community Source License.
     38The source code cannot be downloaded from some countries, so for users
     39from those countries, the binary may be the only option.</para>
     40                                                                               
     41<para>Even if you plan on compiling the <acronym>JDK</acronym> source, you will                                                                               
     42need to download the binary version to bootstrap the <acronym>JDK</acronym>
     43build. Follow the link below to download both source and binary packages. When
     44downloading the source also download the <application>Mozilla</application>
     45headers package available at the same location.</para>
     46                                                                               
     47<!--
     48<para>For users who cannot download the <application>J2SDK</application> source owing to license restrictions, <application>blackdown
     49</application> has an <acronym>GCC</acronym>-3 based precompiled version.
     50Check out <ulink url="http://www.blackdown.org/"/> for more
     51information.</para>
     52-->
     53                                                                               
     54<sect3><title>Package information</title>
     55<itemizedlist spacing='compact'>
     56<listitem><para>Download (HTTP): <ulink
     57url="&j2sdk-download-http;"/></para></listitem>
     58
     59<!--
     60<listitem><para>Download (FTP): <ulink
     61url="&j2sdk-download-ftp;"/></para></listitem>
     62-->
     63<listitem><para>Version used (binary):
     64&j2sdk-bin-version;</para></listitem>
     65<listitem><para>Download size (binary): &j2sdk-bin-size;</para></listitem>
     66<listitem><para>Download size (source): &j2sdk-src-size;</para></listitem>
     67<listitem><para>Estimated Disk space required:
     68&j2sdk-src-buildsize;</para></listitem>
     69<listitem><para>Estimated build time:
     70&j2sdk-time;</para></listitem></itemizedlist>
     71</sect3>
     72                                                                               
     73<sect3><title>Additional downloads</title>
     74<itemizedlist spacing='compact'>
     75<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-fix-inline-asm-1.patch"/></para></listitem>
     76<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-gcc33-1.patch"/></para></listitem>
     77<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-motif-mkmsgcat.patch"/></para></listitem>
     78<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-debug-image.patch"/></para></listitem>
     79<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-fixed-paths-1.patch"/></para></listitem>
     80<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-static_cxx.patch"/></para></listitem>
     81<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-ash.patch"/> (Only required if /bin/sh is symlinked to <xref linkend="ash"/>)</para></listitem>
     82</itemizedlist>
     83</sect3>
     84                                                                               
     85                                                                               
     86<sect3><title><application>J2SDK</application> dependencies</title>
     87<sect4><title>Required</title>
     88<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="zip"/>, <xref
     89linkend="unzip"/>, <xref linkend="cpio"/>, <xref linkend="alsa"/>,
     90and <xref linkend="tcsh"/>
     91</para></sect4>
     92</sect3>
     93                                                                               
     94</sect2>
     95
     96<sect2>
     97<title>Installation of <application>J2SDK</application></title>
     98                                                                               
     99<para>Both versions will be installed in parallel. You may choose to keep
     100either or both.</para>
     101                                                                               
     102<para>Installation of the precompiled <acronym>JDK</acronym> is easy:
     103create a directory to install from, copy the .bin there, and run the
     104following commands:</para>
     105                                                                               
     106<screen><userinput><command>VERSION=&j2sdk-bin-version; &amp;&amp;
     107MV=`echo $VERSION | cut -d "_" -f 1,1` &amp;&amp;
     108V=`echo ${VERSION} | sed -e "s/\./_/g"` &amp;&amp;
     109sed -i "s:^PATH=.*::" j2sdk-${V}-linux-i?86.bin &amp;&amp;
     110chmod +x j2sdk-${V}-linux-i?86.bin &amp;&amp;
     111mkdir -p bin &amp;&amp;
     112ln -sf /bin/true bin/more &amp;&amp;
     113yes | PATH=$PWD/bin:$PATH ./j2sdk-${V}-linux-i?86.bin &amp;&amp;
     114cd j2sdk${VERSION} &amp;&amp;
     115install -d /opt/j2sdk/j2sdk-precompiled-${MV} &amp;&amp;
     116mv * /opt/j2sdk/j2sdk-precompiled-${MV}</command></userinput></screen>
     117                                                                               
     118<para>The binary version is now installed.  </para>
     119                                                                               
     120<para>If you don't want to compile the source or are not in a postition to download the source
     121owing to license restrictions, skip ahead to the configuration
     122section.</para>
     123                                                                               
     124<para>Add the recently compiled <acronym>JDK</acronym> to the path.</para>
     125<screen><userinput><command>export JAVA_HOME=/opt/j2sdk/j2sdk-precompiled-${MV} &amp;&amp;
     126export PATH=$PATH:${JAVA_HOME}/bin</command></userinput></screen>
     127                                                                               
     128<para>Unzip the source:</para>
     129                                                                               
     130<screen><userinput><command>VERSION=&j2sdk-src-version; &amp;&amp;
     131V=`echo $VERSION | sed -e "s/\./_/g"` &amp;&amp;
     132unzip j2sdk-${V}-src-scsl.zip &amp;&amp;
     133unzip j2sdk-${V}-mozilla_headers-unix.zip &amp;&amp;
     134unzip j2sdk-${V}-bin-scsl.zip</command></userinput></screen>
     135                                                                               
     136<para>Apply all the patches downloaded above.</para>
     137                                                                               
     138<screen><userinput><command>for PATCH in fix-inline-asm-1 gcc33-1 motif-mkmsgcat \
     139             remove-debug-image remove-fixed-paths-1 \
     140             static_cxx
     141do
     142   patch -Np1 -i j2sdk-1.4.2-$PATCH.patch
     143done</command></userinput></screen>
     144                                                                               
     145<para>Set/unset some variables which affect the build:</para>
     146<screen><userinput><command>export ALT_BOOTDIR="$JAVA_HOME" &amp;&amp;
     147unset JAVA_HOME &amp;&amp;
     148unset CLASSPATH
     149unset CFLAGS
     150unset CXXFLAGS
     151unset LDFLAGS
     152export ALT_DEVTOOLS_PATH="/usr/bin" &amp;&amp;
     153export BUILD_NUMBER="blfs-`date +%s`" &amp;&amp;
     154export DEV_ONLY=true &amp;&amp;
     155export ALT_MOZILLA_PATH=$PWD &amp;&amp;
     156export INSANE=true &amp;&amp;
     157export MAKE_VERBOSE=true &amp;&amp;
     158export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts</command></userinput></screen>
     159                                                                               
     160<warning><para>Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make the build fail.
     161If you are interested in optimizing the build, set OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS
     162instead.</para></warning>
     163                                                                               
     164<para>Additionally, if you would like to make in parallel, add the following
     165(adjust <envar>MAKE_PARALLEL</envar> to your liking):</para>
     166<screen><userinput><command>export HOTSPOT_BUILD_JOBS=$MAKE_PARALLEL</command></userinput></screen>
     167                                                                               
     168<para>If the included <application>Motif</application> doesn't build properly, the
     169error is noticed much later in the build.
     170A solution is to build the <application>Motif</application>
     171library before compiling the <application>J2SDK</application>.</para>
     172                                                                               
     173<screen><userinput><command>cd motif/lib/Xm &amp;&amp;
     174make &amp;&amp;
     175cd ../../..</command></userinput></screen>
     176                                                                               
     177<para>Make and Install <application>J2SDK</application> with the following
     178commands. There will be a lot of messages about missing files that look like
     179errors. As long as the build doesn't stop, the messages are harmless, so ignore                                                                               
     180them.</para>
     181                                                                               
     182<screen><userinput><command>cd control/make &amp;&amp;
     183make &amp;&amp;
     184cd ../.. &amp;&amp;
     185cd control/build/linux-i?86 &amp;&amp;
     186cp -a j2sdk-image /opt/j2sdk/j2sdk-&j2sdk-src-version;</command></userinput></screen>
     187                                                                               
     188</sect2>
     189
     190<sect2>
     191<title>Command explanations</title>
     192                                                                               
     193<para><command>export ALT_BOOTDIR="$JAVA_HOME"</command>: This var sets
     194location of the bootstrap <acronym>JDK</acronym>.
     195</para>
     196                                                                               
     197<para><command>export ALT_MOZILLA_PATH=$PWD</command>: This sets the
     198variable that points to where you unzipped the <application>Mozilla
     199</application> headers.</para>
     200                                                                               
     201<para><command>export ALT_DEVTOOLS_PATH="/usr/bin"</command>: This
     202changes the location where the build finds the needed executables.
     203</para>
     204                                                                               
     205<para><command>export BUILD_NUMBER="blfs-`date +%s`"</command>: This will
     206help you identify this compiled version of the runtime environment and
     207virtual machine by appending this information to the version in the
     208output to <command>java -version</command>.</para>
     209                                                                               
     210<para><command>export DEV_ONLY=true</command>: This command
     211eliminates compiling the documentation and eliminates a dependency for
     212<application>rpm</application>. </para>
     213                                                                               
     214<para><command>unset JAVA_HOME</command>: This clears the
     215<envar>JAVA_HOME</envar>
     216variable as recommended by the build instructions.</para>
     217                                                                               
     218<para><command>unset CLASSPATH</command>: This clears the
     219<envar>CLASSPATH</envar> variable as per the recommendations in the build instructions.
     220</para>
     221                                                                               
     222<para><command>unset CFLAGS...</command>: These flags cause miscompilation
     223of the build. Never set these.</para>
     224                                                                               
     225<para><command>export INSANE=true</command>: Unless you specify that you
     226are insane the build will not proceed. The certified platform for the build is
     227Redhat 6.1. The above variable ensures that all the errors related to
     228compiling on a non-certified platform will be converted to warnings.</para>
     229                                                                               
     230<para><command>export MAKE_VERBOSE=true</command>: Allows the current
     231compilation command to be displayed on the console.</para>
     232                                                                               
     233<para><command>export ALT_CACERTS_FILE...</command>: Specifies the
     234certificate file to use.</para>
     235                                                                               
     236</sect2>
     237
     238<sect2>
     239<title>Configuring <application>J2SDK</application></title>
     240                                                                               
     241<sect3><title>Configuration Information</title>
     242                                                                               
     243<para>We have two Java 2 <acronym>SDK</acronym>'s installed in
     244<filename>/opt/j2sdk</filename>. Decide on which one you
     245would like to use as the default. For example if you decide to use the source
     246compiled <application>J2SDK</application>, do the following:</para>
     247                                                                               
     248<screen><userinput><command>ln -nsf j2sdk-&j2sdk-src-version; /opt/j2sdk/j2sdk</command></userinput></screen>
     249                                                                               
     250<para>Add the following lines to your shell startup file (e.g.,
     251<filename>/etc/profile</filename>).</para>
     252                                                                               
     253<screen><userinput>export JAVA_HOME=/opt/j2sdk/j2sdk
     254export PATH=$PATH:$JAVA_HOME/bin</userinput></screen>
     255                                                                               
     256<para>Add <filename>$JAVA_HOME/man</filename> to your
     257<envar>MANPATH</envar> variable or to
     258<filename>/etc/man.conf</filename></para>
     259                                                                               
     260<para>The <application>Java</application> plugin is in the directory
     261<filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns610/</filename>.
     262Make a symbolic link to the file in that directory from your plugins directory.</para>
     263                                                                               
     264</sect3>
     265                                                                               
     266<sect3><title>Handling CLASSPATH</title>
     267                                                                               
     268<para>When compiling packages, the <envar>CLASSPATH</envar> environment variable
     269is used by JDK to locate classes at compile-time and run-time. It is tedious toadd all the classes used to the <envar>CLASSPATH</envar> manually. You may add
     270the following lines to your shell startup file to set <envar>CLASSPATH</envar>
     271automatically to include all JAR files in a specified directory, which in
     272the example below is <filename>/usr/lib/auto-java-classpath</filename>.</para>
     273                                                                               
     274<screen><userinput>AUTO_CLASSPATH_DIR=/usr/lib/auto-java-classpath
     275if [ -z $CLASSPATH ]
     276then
     277  CLASSPATH=.:$AUTO_CLASSPATH_DIR
     278else
     279  CLASSPATH=$CLASSPATH:.:$AUTO_CLASSPATH_DIR
     280fi
     281for i in $(ls $AUTO_CLASSPATH_DIR/*.jar 2>/dev/null)
     282do
     283  CLASSPATH=$CLASSPATH:$i
     284done</userinput></screen>
     285                                                                               
     286</sect3>
     287                                                                               
     288</sect2>
     289
     290<sect2>
     291<title>Contents</title>
     292                                                                               
     293<para>The <application>J2SDK</application> package contains
     294<command>appletviewer</command>,
     295<command>extcheck</command>, <command>idlj</command>,
     296<command>jar</command>, <command>jarsigner</command>,
     297<command>java</command>, <command>javac</command>,
     298<command>javadoc</command>, <command>javah</command>,
     299<command>javap</command>, <command>jdb</command>,
     300<command>keytool</command>, <command>native2ascii</command>,
     301<command>orbd</command>, <command>policytool</command>,
     302<command>rmic</command>, <command>rmid</command>,
     303<command>rmiregistry</command>, <command>rmiregistry</command>,
     304<command>serialver</command>, <command>servertool</command> and
     305<command>tnameserv</command>.</para>
     306                                                                               
     307</sect2>
     308                                                                               
     309<sect2><title>Description</title>
     310                                                                               
     311<sect3><title>appletviewer</title>
     312<para><command>appletviewer</command> runs
     313<application>Java</application> applets outside of the context of a
     314browser.</para></sect3>
     315                                                                               
     316<sect3><title>extcheck</title>
     317<para><command>extcheck</command> checks a specified <filename>JAR</filename>
     318file for title and version conflicts with any extensions installed in the
     319<acronym>JDK</acronym> software.</para></sect3>
     320                                                                               
     321<sect3><title>idlj</title>
     322<para><command>idlj</command> generates <application>Java</application>
     323bindings from a given <acronym>IDL</acronym> file.</para></sect3>
     324                                                                               
     325<sect3><title>jar</title>
     326<para><command>jar</command> combines multiple files into a single
     327<acronym>JAR</acronym> archive file.</para></sect3>
     328                                                                               
     329<sect3><title>jarsigner</title>
     330<para><command>jarsigner</command> signs <filename>JAR</filename>
     331(Java ARchive) files and verifies the signatures and integrity of a signed
     332<filename>JAR</filename>.</para></sect3>
     333                                                                               
     334<sect3><title>java</title>
     335<para><command>java</command> launches a <application>Java</application>
     336application by starting a <application>Java</application> runtime
     337environment, loading a specified class and invoking its main
     338method.</para></sect3>
     339                                                                               
     340<sect3><title>javac</title>
     341<para><command>javac</command> reads class and interface definitions, written
     342in the <application>Java</application> programming language, and compiles them
     343into bytecode class files.</para></sect3>
     344                                                                               
     345<sect3><title>javadoc</title>
     346<para><command>javadoc</command> parses the declarations and documentation
     347comments in a set of <application>Java</application> source files and produces
     348a corresponding set of <acronym>HTML</acronym> pages describing the classes,
     349interfaces, constructors, methods, and fields.</para></sect3>
     350                                                                               
     351<sect3><title>javah</title>
     352<para><command>javah</command> generates <application>C</application> header
     353and source files that are needed to implement native methods.</para></sect3>
     354                                                                               
     355<sect3><title>javap</title>
     356<para><command>javap</command> disassembles a
     357<application>Java</application> class file.</para></sect3>
     358                                                                               
     359<sect3><title>jdb</title>
     360<para><command>jdb</command> is a simple command-line debugger for
     361<application>Java</application> classes.</para></sect3>
     362                                                                               
     363<sect3><title>keytool</title>
     364<para><command>keytool</command> is a key and certificate management utility.</para></sect3>
     365                                                                               
     366<sect3><title>native2ascii</title>
     367<para><command>native2ascii</command> converts files that contain non-supported
     368character encoding into files containing Latin-1 or Unicode-encoded characters.</para></sect3>
     369                                                                               
     370<sect3><title>orbd</title>
     371<para><command>orbd</command> is used to enable clients to transparently locate
     372and invoke persistent objects on servers in the <acronym>CORBA</acronym>
     373environment.</para></sect3>
     374                                                                               
     375<sect3><title>policytool</title>
     376<para><command>policytool</command> creates and manages a policy file
     377graphically.</para></sect3>
     378                                                                               
     379<sect3><title>rmic</title>
     380<para><command>rmic</command> generates stub and skeleton class files for
     381remote objects from the names of compiled <application>Java</application>
     382classes that contain remote object implementations.</para></sect3>
     383                                                                               
     384<sect3><title>rmid</title>
     385<para><command>rmid</command> starts the activation system daemon.</para>
     386</sect3>
     387                                                                               
     388<sect3><title>rmiregistry</title>
     389<para><command>rmiregistry</command> creates and starts a remote object
     390registry on the specified port on the current host.</para></sect3>
     391                                                                               
     392<sect3><title>serialver</title>
     393<para><command>serialver</command> returns the serialVersionUID for one or
     394more classes in a form suitable for copying into an evolving class.</para>
     395</sect3>
     396                                                                               
     397<sect3><title>servertool</title>
     398<para><command>servertool</command> provides an ease-of-use interface for
     399application programmers to register, unregister, startup and shutdown a server.</para></sect3>
     400                                                                               
     401<sect3><title>tnameserv</title>
     402<para><command>tnameserv</command> starts the <application>Java</application>
     403<acronym>IDL</acronym> name server.</para></sect3>
     404
     405</sect2>
    10406
    11407</sect1>

  • general/prog/librep.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY librep-download-http "http://prdownloads.sourceforge.net/librep/librep-&librep-version;.tar.gz">
     8<!ENTITY librep-download-ftp " ">
     9<!ENTITY librep-size "1.2 MB">
     10<!ENTITY librep-buildsize "11 MB">
     11<!ENTITY librep-time "0.64 SBU">
     12
     13]>
     14
    115<sect1 id="librep" xreflabel="librep-&librep-version;">
    216<?dbhtml filename="librep.html" ?>
    317<title>librep-&librep-version;</title>
    418
    5 &librep-intro;
    6 &librep-inst;
    7 &librep-exp;
    8 &librep-desc;
     19<sect2>
     20<title>Introduction to <application>librep</application></title>
     21                                                                               
     22<para>The <application>librep</application> package contains a Lisp system.
     23This is useful for scripting or for applications that may use the Lisp
     24interpreter as an extension language.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&librep-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&librep-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &librep-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&librep-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&librep-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39                                                                               
     40<sect3><title><application>librep</application> dependencies</title>
     41<sect4><title>Required</title>
     42<para><xref linkend="gdbm"/></para></sect4>
     43<sect4><title>Optional</title>
     44<para><xref linkend="gmp"/>, and <xref linkend="readline"/></para></sect4>
     45<!--
     46<ulink url="http://sources.redhat.com/libffi/">libffi</ulink>
     47-->
     48</sect3>
     49                                                                               
     50</sect2>
     51
     52<sect2>
     53<title>Installation of <application>librep</application></title>
     54                                                                               
     55<para>Install <application>librep</application> by running the following
     56commands:</para>
     57                                                                               
     58<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib &amp;&amp;
     59make &amp;&amp;
     60make install</command></userinput></screen>
     61                                                                               
     62</sect2>
     63
     64<sect2>
     65<title>Command explanations</title>
     66                                                                               
     67<para><parameter>--libexecdir=/usr/lib</parameter>: This command installs
     68files to <filename class="directory">/usr/lib/rep</filename> instead of
     69<filename class="directory">/usr/libexec/rep</filename>.</para>
     70                                                                               
     71</sect2>
     72
     73<sect2>
     74<title>Contents</title>
     75                                                                               
     76<para>The <application>librep</application> package contains
     77<command>rep</command>,
     78<command>rep-config</command>,
     79<command>rep-remote</command>,
     80<command>rep-xgettext</command>,
     81<command>repdoc</command> and
     82<filename class="libraryfile">librep</filename> libraries.</para>
     83                                                                               
     84</sect2>
     85                                                                               
     86<sect2><title>Description</title>
     87                                                                               
     88<sect3><title>rep</title>
     89<para><command>rep</command> is the Lisp interpreter.</para></sect3>
     90                                                                               
     91<sect3><title>librep libraries</title>
     92<para><filename class="libraryfile">librep</filename> libraries contain
     93the functions necessary for the Lisp interpreter.</para></sect3>
     94                                                                               
     95</sect2>
    996
    1097</sect1>

  • general/prog/nasm.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY NASM-download-http "http://prdownloads.sourceforge.net/nasm/nasm-&NASM-version;.tar.bz2">
     8<!ENTITY NASM-download-ftp " ">
     9<!ENTITY NASM-size "536 KB">
     10<!ENTITY NASM-buildsize "6.3 MB">
     11<!ENTITY NASM-time "0.14 SBU">
     12
     13]>
     14
    115<sect1 id="NASM" xreflabel="NASM-&NASM-version;">
    216<?dbhtml filename="NASM.html" ?>
    317<title>NASM-&NASM-version;</title>
    418
    5 &NASM-intro;
    6 &NASM-inst;
    7 &NASM-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>NASM</acronym></application></title>
     21                                                                               
     22<para><application><acronym>NASM</acronym></application> (Netwide Assembler) is                                                                               
     23an 80x86 assembler designed for portability and modularity. It includes a
     24disassembler as well.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&NASM-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&NASM-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &NASM-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &NASM-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &NASM-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35</sect2>
     36
     37<sect2>
     38<title>Installation of <application><acronym>NASM</acronym></application></title>
     39                                                                               
     40<para>Install <application><acronym>NASM</acronym></application> by running thefollowing commands:</para>
     41                                                                               
     42<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     43make &amp;&amp;
     44make install</command></userinput></screen>
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Contents</title>
     50                                                                               
     51<para>The <application><acronym>NASM</acronym></application> package contains <command>nasm
     52</command> and <command>ndisasm</command> programs.</para>
     53                                                                               
     54</sect2>
     55                                                                               
     56<sect2><title>Description</title>
     57                                                                               
     58<sect3><title>nasm</title>
     59<para><command>nasm</command> is a portable 80x86 assembler.</para></sect3>
     60                                                                               
     61<sect3><title>ndisasm</title>
     62<para><command>ndisasm</command> is an 80x86 binary file disassembler.</para></sect3>
     63                                                                               
     64</sect2>
    865
    966</sect1>

  • general/prog/perl-modules.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY Gtk-Perl-version          "0.7009">
     8<!ENTITY PDL-version               "2.4.0">
     9<!ENTITY XML-Parser-version        "2.34">
     10<!ENTITY XML-Writer-version        "0.4.1">
     11<!ENTITY Astro-FITS-Header-version "2.8.1">
     12<!ENTITY Parse-RecDescent-version  "1.94">
     13
     14]>
     15
    116<sect1 id="perl-modules" xreflabel="Perl modules">
    217<?dbhtml filename="perl-modules.html" ?>
    318<title>Perl modules</title>
    419
    5 &perl-modules-intro;
    6 &perl-modules-inst;
     20<sect2>
     21<title>Introduction to <application>Perl</application> modules</title>
     22
     23<para>The <application>Perl</application> module packages add useful objects
     24to the <application>Perl</application> language.  Modules utilized by packages
     25throughout <acronym>BLFS</acronym> are listed here, along with their
     26dependencies.</para>
     27
     28<sect3><title>Perl Packages</title>
     29<itemizedlist spacing='compact'>
     30<listitem><para><ulink
     31url="http://search.cpan.org/CPAN/authors/id/C/CS/CSOE/PDL-&PDL-version;.tar.gz">PDL-&PDL-version;</ulink></para><itemizedlist spacing='compact'>
     32
     33<listitem><para><ulink
     34url="http://search.cpan.org/CPAN/authors/id/A/AA/AALLAN/Astro-FITS-Header-&Astro-FITS-Header-version;.tar.gz">Astro-FITS-Header-&Astro-FITS-Header-version;</ulink></para></listitem></itemizedlist></listitem>
     35
     36<listitem><para><ulink
     37url="http://search.cpan.org/CPAN/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz">Gtk-Perl-&Gtk-Perl-version;</ulink></para><itemizedlist spacing='compact'>
     38
     39<listitem><para><ulink
     40url="http://search.cpan.org/CPAN/authors/id/E/ED/EDAVIS/XML-Writer-&XML-Writer-version;.tar.gz">XML-Writer-&XML-Writer-version;</ulink></para></listitem>
     41
     42<listitem><para><ulink
     43url="http://search.cpan.org/CPAN/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">XML-Parser-&XML-Parser-version;</ulink>
     44</para></listitem></itemizedlist></listitem>
     45
     46<listitem><para><ulink
     47url="http://search.cpan.org/CPAN/authors/id/D/DC/DCONWAY/Parse-RecDescent-&Parse-RecDescent-version;.tar.gz">Parse-RecDescent-&Parse-RecDescent-version;</ulink></para></listitem></itemizedlist>
     48
     49</sect3>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Installation of <application>Perl</application> modules</title>
     55                                                                               
     56<para>Install <application>Perl</application> modules by running the following
     57commands:</para>
     58                                                                               
     59<screen><userinput><command>perl Makefile.PL &amp;&amp;
     60make &amp;&amp;
     61make install</command></userinput></screen>
     62                                                                               
     63<para>The module listed below requires a modification in order to install
     64successfully.</para>
     65                                                                               
     66<para>Gtk-Perl-&Gtk-Perl-version;:</para>
     67                                                                               
     68<screen><userinput><command>perl Makefile.PL --without-guessing &amp;&amp;
     69make &amp;&amp;
     70make install</command></userinput></screen>
     71                                                                               
     72</sect2>
     73
     74<sect2><title>(Alternate) Auto installation of <application>Perl</application>
     75modules.</title>
     76                                                                               
     77<para>There is an alternate way of installing the modules using
     78<application>Perl</application>'s built-in <command>install</command> command.
     79The command automatically downloads the source from the <acronym>CPAN</acronym>archive, extracts it, runs the commands mentioned above, and removes
     80the build tree.</para>
     81                                                                               
     82<para>Start the perl shell with the commands:</para>
     83                                                                               
     84<screen><userinput><command>perl -MCPAN -e shell</command></userinput></screen>                                                                               
     85<para>Each module may now be installed from this shell with the command:</para>                                                                               
     86<screen><userinput><command>install &lt;moduleName&gt;</command></userinput></screen>
     87                                                                               
     88<para>For additional commands and help, type <command>help</command>.</para>
     89                                                                               
     90</sect2>
    791
    892</sect1>

  • general/prog/prog.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4 <!ENTITY % general-entities SYSTEM "../../general.ent">
     5 %general-entities;
     6]>
     7
    18<chapter id="general-prog">
    29<?dbhtml filename="prog.html" ?>
    … …  
    1017system's development capabilities.</para>
    1118
    12 &Python;
    13 &perl-modules;
    14 &librep;
    15 &j2sdk;
    16 &ruby;
    17 &gcc;
    18 &tcl;
    19 &tk;
    20 &gcc2;
    21 &NASM;
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="python.xml"/>
     20<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="perl-modules.xml"/>
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="librep.xml"/>
     22<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="j2sdk.xml"/>
     23<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ruby.xml"/>
     24<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc.xml"/>
     25<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tcl.xml"/>
     26<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tk.xml"/>
     27<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc2.xml"/>
     28<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nasm.xml"/>
    2229
    2330</chapter>

  • general/prog/python.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY Python-download-http "http://www.python.org/ftp/python/&Python-version;/Python-&Python-version;.tar.bz2">
     8<!ENTITY Python-download-ftp "ftp://ftp.python.org/pub/python/&Python-version;/Python-&Python-version;.tar.bz2">
     9<!ENTITY Python-size "6.9 MB">
     10<!ENTITY Python-buildsize "69 MB">
     11<!ENTITY Python-time "1.25 SBU">
     12
     13]>
     14
    115<sect1 id="Python" xreflabel="Python-&Python-version;">
    216<?dbhtml filename="Python.html" ?>
    317<title>Python-&Python-version;</title>
    418
    5 &Python-intro;
    6 &Python-inst;
    7 &Python-desc;
     19<sect2>
     20<title>Introduction to <application>Python</application></title>
     21                                                                               
     22<para>The <application>Python</application> package contains the
     23<application>Python</application> development environment.
     24This is useful for object-oriented programming, writing scripts,
     25prototyping large programs or developing entire applications.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&Python-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&Python-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &Python-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &Python-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &Python-time;</para></listitem></itemizedlist>
     34</sect3>
     35                                                                               
     36<sect3><title>Additional downloads</title>
     37<itemizedlist spacing='compact'>
     38<listitem><para>Required patch (HTTP): <ulink
     39url="&patch-root;/Python-&Python-version;-gdbm-2.patch"/></para></listitem>
     40</itemizedlist>
     41</sect3>
     42                                                                               
     43<sect3><title><application>Python</application> dependencies</title>
     44<sect4><title>Optional</title>
     45<para><xref linkend="expat"/>, <xref linkend="tk"/>, <xref
     46linkend="gdbm"/>, <xref linkend="db"/>, <xref linkend="gmp"/> and
     47<xref linkend="readline"/>
     48</para></sect4>
     49</sect3>
     50
     51</sect2>                                                                               
     52
     53<sect2>
     54<title>Installation of <application>Python</application></title>
     55                                                                               
     56<para>Install <application>Python</application> by running the following commands:</para>
     57                                                                               
     58<screen><userinput><command>patch -Np1 -i ../Python-&Python-version;-gdbm-2.patch &amp;&amp;
     59./configure --prefix=/usr --enable-shared &amp;&amp;
     60make &amp;&amp;
     61make install</command></userinput></screen>
     62                                                                               
     63</sect2>
     64
     65<sect2>
     66<title>Contents</title>
     67                                                                               
     68<para>The <application>Python</application> package contains <command>python</command> and
     69<command>pydoc</command>.</para>
     70                                                                               
     71</sect2>
     72                                                                               
     73<sect2><title>Description</title>
     74                                                                               
     75<sect3><title>python</title>
     76<para><command>python</command> is an interpreted, interactive, object-oriented programming
     77language.</para></sect3>
     78                                                                               
     79<sect3><title>pydoc</title>
     80<para><command>pydoc</command> is the <application>Python</application> documentation tool.</para></sect3>
     81                                                                               
     82</sect2>
    883
    984</sect1>

  • general/prog/ruby.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY ruby-download-http "http://rubyforge.org/download.php/262/ruby-&ruby-version;.tar.gz">
     8<!ENTITY ruby-download-ftp " ">
     9<!ENTITY ruby-size "2.6 MB">
     10<!ENTITY ruby-buildsize "31 MB">
     11<!ENTITY ruby-time "0.71 SBU">
     12
     13]>
     14
    115<sect1 id="ruby" xreflabel="Ruby-&ruby-version;">
    216<?dbhtml filename="ruby.html"?>
    317<title>Ruby-&ruby-version;</title>
    418
    5 &ruby-intro;
    6 &ruby-inst;
    7 &ruby-desc;
     19<sect2>
     20<title>Introduction to <application>Ruby</application></title>
     21                                                                               
     22<para>The <application>Ruby</application> package contains the
     23<application>Ruby</application> development environment. This
     24is useful for object-oriented scripting.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&ruby-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&ruby-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &ruby-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &ruby-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &ruby-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35</sect2>
     36
     37<sect2>
     38<title>Installation of <application>Ruby</application></title>
     39                                                                               
     40<para>Install <application>Ruby</application> by running the following commands:</para>
     41                                                                               
     42<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     43make &amp;&amp;
     44make install</command></userinput></screen>
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Contents</title>
     50                                                                               
     51<para>The <application>Ruby</application> package contains
     52<command>ruby</command>,
     53<command>irb</command>,
     54<command>erb</command>,
     55<command>rdoc</command>,
     56<command>ri</command> and
     57<command>testrb</command>.</para>
     58                                                                               
     59</sect2>
     60                                                                               
     61<sect2><title>Description</title>
     62                                                                               
     63<sect3><title>ruby</title>
     64<para><command>ruby</command> is an interpreted scripting language for quick
     65and easy object-oriented programming.</para></sect3>
     66                                                                               
     67<sect3><title>irb</title>
     68<para><command>irb</command> is the interactive interface for ruby.</para>
     69</sect3>
     70                                                                               
     71</sect2>
    872
    973</sect1>

  • general/prog/tcl.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY tcl-download-http "http://prdownloads.sourceforge.net/tcl/tcl&tcl-version;-src.tar.gz">
     8<!ENTITY tcl-download-ftp "ftp://ftp.us.xemacs.org/pub/tcl/tcl8_4/tcl&tcl-version;-src.tar.gz">
     9<!ENTITY tcl-size "3.3 MB">
     10<!ENTITY tcl-buildsize "17.1 MB">
     11<!ENTITY tcl-time "0.27 SBU">
     12
     13]>
     14
    115<sect1 id="tcl" xreflabel="Tcl-&tcl-version;">
    216<?dbhtml filename="tcl.html"?>
    317<title>Tcl-&tcl-version;</title>
    418
    5 &tcl-intro;
    6 &tcl-inst;
    7 &tcl-exp;
     19<sect2>
     20<title>Introduction to <application>Tcl</application></title>
     21                                                                               
     22<para>The <application>Tcl</application> package contains Tool Command Language.  </para>
     23                                                                               
     24<sect3><title>Package information</title>
     25<itemizedlist spacing='compact'>
     26<listitem><para>Download (HTTP): <ulink
     27url="&tcl-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink
     29url="&tcl-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &tcl-size;</para></listitem>
     31<listitem><para>Estimated Disk space required:
     32&tcl-buildsize;</para></listitem>
     33<listitem><para>Estimated build time:
     34&tcl-time;</para></listitem></itemizedlist>
     35</sect3>
     36                                                                               
     37</sect2>
     38
     39<sect2>
     40<title>Installation of <application>Tcl</application></title>
     41                                                                               
     42<note><para>This package is also installed in <acronym>LFS</acronym>
     43during the bootstrap phase. The significant difference between the
     44two installations (other than installing to <filename class="directory">/usr</filename>) is to install
     45the package in such a way that there is no need to keep the build
     46directory around after installation.</para></note>
     47                                                                               
     48<para>Install <application>Tcl</application> by running the following commands:</para>
     49                                                                               
     50<screen><userinput><command>VERSION=&tcl-version; &amp;&amp;
     51V=`echo $VERSION | cut -d "." -f 1,2` &amp;&amp;
     52DIR=$PWD &amp;&amp;
     53cd unix &amp;&amp;
     54./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56sed -i "s:${DIR}/unix:/usr/lib:" tclConfig.sh &amp;&amp;
     57sed -i "s:${DIR}:/usr/include/tcl${V}:" tclConfig.sh &amp;&amp;
     58sed -i "s,^TCL_LIB_FILE='libtcl${V}..TCL_DBGX..so',TCL_LIB_FILE=\"libtcl${V}\$\{TCL_DBGX\}.so\"," \
     59    tclConfig.sh &amp;&amp;
     60mv ../doc/{,Tcl_}Thread.3 &amp;&amp;
     61sed -i 's/ Thread.3/ Tcl_Thread.3/' mkLinks &amp;&amp;
     62make install &amp;&amp;
     63install -d /usr/include/tcl${V}/unix &amp;&amp;
     64install -m644 *.h /usr/include/tcl${V}/unix/ &amp;&amp;
     65install -d /usr/include/tcl${V}/generic &amp;&amp;
     66install -c -m644 ../generic/*.h /usr/include/tcl${V}/generic/ &amp;&amp;
     67rm -f /usr/include/tcl${V}/generic/{tcl,tclDecls,tclPlatDecls}.h &amp;&amp;
     68ln -nsf /usr/include/tcl${V} /usr/lib/tcl${V}/include &amp;&amp;
     69ln -sf libtcl${V}.so /usr/lib/libtcl.so &amp;&amp;
     70ln -sf tclsh${V} /usr/bin/tclsh</command></userinput></screen>
     71                                                                               
     72</sect2>
     73
     74<sect2>
     75<title>Command explanations</title>
     76                                                                               
     77<para><command>sed -i ...</command>: The <application>Tcl</application>
     78package assumes that the source that is used to build <application>Tcl
     79</application> is always kept around for compiling packages that depend on
     80<application>Tcl</application>. These <command>sed</command>'s remove the
     81reference to the build directory and replace them by saner system wide
     82locations.</para>
     83                                                                               
     84<para><command>install ...</command>: These commands install the internal
     85headers into a system-wide location.</para>
     86                                                                               
     87<para><command>ln -sf ...</command>: These commands create compatibility
     88symbolic links.</para>
     89                                                                               
     90</sect2>
    891
    992</sect1>

  • general/prog/tk.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY tk-download-http "http://prdownloads.sourceforge.net/tcl/tk&tk-version;-src.tar.gz">
     8<!ENTITY tk-download-ftp "ftp://ftp.us.xemacs.org/pub/tcl/tcl8_4/tk&tk-version;-src.tar.gz">
     9<!ENTITY tk-size "3.1 MB">
     10<!ENTITY tk-buildsize "17.4 MB">
     11<!ENTITY tk-time "0.41 SBU">
     12
     13]>
     14
    115<sect1 id="tk" xreflabel="Tk-&tk-version;">
    216<?dbhtml filename="tk.html"?>
    317<title>Tk-&tk-version;</title>
    418
    5 &tk-intro;
    6 &tk-inst;
    7 &tk-exp;
     19<sect2>
     20<title>Introduction to <application>Tk</application></title>
     21                                                                               
     22<para>The <application>Tk</application> package contains
     23<acronym>TCL</acronym> <acronym>GUI</acronym> Toolkit.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&tk-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&tk-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &tk-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&tk-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&tk-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title><application>Tk</application> dependencies</title>
     39<sect4><title>Required</title>
     40<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="tcl"/></para></sect4>
     41</sect3>
     42
     43</sect2>
     44
     45<sect2>
     46<title>Installation of <application>Tk</application></title>
     47                                                                               
     48<para>Install <application>Tk</application> by running the following commands:</para>
     49                                                                               
     50<screen><userinput><command>VERSION=&tk-version; &amp;&amp;
     51V=`echo $VERSION | cut -d "." -f 1,2` &amp;&amp;
     52DIR=$PWD &amp;&amp;
     53cd unix &amp;&amp;
     54./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56sed -i "s:${DIR}/unix:/usr/lib:" tkConfig.sh &amp;&amp;
     57sed -i "s:${DIR}:/usr/include/tk${V}:" tkConfig.sh &amp;&amp;
     58make install &amp;&amp;
     59install -d /usr/include/tk${V}/unix &amp;&amp;
     60install -m644 *.h /usr/include/tk${V}/unix/ &amp;&amp;
     61install -d /usr/include/tk${V}/generic &amp;&amp;
     62install -m644 ../generic/*.h /usr/include/tk${V}/generic/ &amp;&amp;
     63rm -f /usr/include/tk${V}/generic/{tk,tkDecls,tkPlatDecls}.h &amp;&amp;
     64ln -nsf /usr/include/tk${V} /usr/lib/tk${V}/include &amp;&amp;
     65ln -sf libtk${V}.so /usr/lib/libtk.so &amp;&amp;
     66ln -sf wish${V} /usr/bin/wish</command></userinput></screen>
     67                                                                               
     68</sect2>
     69
     70<sect2>
     71<title>Command explanations</title>
     72                                                                               
     73<para><command>sed -i ...</command>: The <application>Tk</application> package
     74assumes that the source that is used to build <application>Tk</application> is
     75always kept around for compiling packages that depend on
     76<application>Tk</application>. These <command>sed</command>'s remove the
     77reference to the build directory and replace them by saner system wide
     78locations.</para>
     79                                                                               
     80<para><command>install ...</command>: These commands install the internal
     81headers into a system-wide location.</para>
     82                                                                               
     83<para><command>ln -sf ...</command>: These commands create compatibility
     84symbolic links.</para>
     85                                                                               
     86</sect2>
    887
    988</sect1>
Note: See TracChangeset for help on using the changeset viewer.