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

File:
1 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>
Note: See TracChangeset for help on using the changeset viewer.