From 58bd309a0541f85ee7d294598f6ca7542d133472 Mon Sep 17 00:00:00 2001 From: Larry Lawrence Date: Fri, 26 Sep 2003 03:06:17 +0000 Subject: [PATCH] update gcc intros git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@1199 af4574ff-66df-0310-9fd7-8a98e5e911e0 --- appendices/glossary.xml | 6 +++ basicnet/netutils/nmap.xml | 4 +- basicnet/netutils/nmap/nmap-desc.xml | 2 +- basicnet/netutils/nmap/nmap-inst.xml | 4 +- basicnet/netutils/nmap/nmap-intro.xml | 6 +-- general/prog/gcc.xml | 4 +- general/prog/gcc/gcc-desc.xml | 67 ++++++++++++++++----------- general/prog/gcc/gcc-exp.xml | 26 +++++++---- general/prog/gcc/gcc-inst.xml | 8 ++-- general/prog/gcc/gcc-intro.xml | 11 +++-- general/prog/gcc/gnat-inst.xml | 23 ++++----- general/prog/gcc/gnat-intro.xml | 18 +++---- general/prog/gcc2.xml | 4 +- general/prog/gcc2/gcc2-config.xml | 16 +++---- general/prog/gcc2/gcc2-desc.xml | 10 ++-- general/prog/gcc2/gcc2-inst.xml | 46 +++++++++--------- general/prog/gcc2/gcc2-intro.xml | 40 ++++++++++------ general/prog/gcc2/gcc2.ent | 1 + 18 files changed, 171 insertions(+), 125 deletions(-) diff --git a/appendices/glossary.xml b/appendices/glossary.xml index 0a071750b6..c4fd5784d5 100644 --- a/appendices/glossary.xml +++ b/appendices/glossary.xml @@ -94,9 +94,15 @@ otherterm="gSMB">SMB FTP File Transfer Protocol +GCC +GNU Compiler Collection + GDK GTK+ Drawing Kit +GNAT +GNU NYU Ada 9x Translator + GNU GNU's Not Unix diff --git a/basicnet/netutils/nmap.xml b/basicnet/netutils/nmap.xml index 3a9ca961c3..f930a39d2c 100644 --- a/basicnet/netutils/nmap.xml +++ b/basicnet/netutils/nmap.xml @@ -1,6 +1,6 @@ - + -nmap-&nmap-version; +Nmap-&nmap-version; &nmap-intro; &nmap-inst; diff --git a/basicnet/netutils/nmap/nmap-desc.xml b/basicnet/netutils/nmap/nmap-desc.xml index b0514f2f91..07582ae4bb 100644 --- a/basicnet/netutils/nmap/nmap-desc.xml +++ b/basicnet/netutils/nmap/nmap-desc.xml @@ -1,7 +1,7 @@ Contents -The nmap package contains +The Nmap package contains nmap. diff --git a/basicnet/netutils/nmap/nmap-inst.xml b/basicnet/netutils/nmap/nmap-inst.xml index 960c6eaac9..307cc66bed 100644 --- a/basicnet/netutils/nmap/nmap-inst.xml +++ b/basicnet/netutils/nmap/nmap-inst.xml @@ -1,7 +1,7 @@ -Installation of <application>nmap</application> +Installation of <application>Nmap</application> -Install nmap by running the following commands: +Install Nmap by running the following commands: ./configure --prefix=/usr && make && diff --git a/basicnet/netutils/nmap/nmap-intro.xml b/basicnet/netutils/nmap/nmap-intro.xml index fc45327e3d..5724c79fca 100644 --- a/basicnet/netutils/nmap/nmap-intro.xml +++ b/basicnet/netutils/nmap/nmap-intro.xml @@ -1,8 +1,8 @@ -Introduction to <application>nmap</application> +Introduction to <application>Nmap</application> -nmap is a utility for network exploration and security -auditing. It supports ping scanning, port scanning and +Nmap is a utility for network exploration and +security auditing. It supports ping scanning, port scanning and TCP/IP fingerprinting. diff --git a/general/prog/gcc.xml b/general/prog/gcc.xml index 4b7ae8f152..fee5fd001e 100644 --- a/general/prog/gcc.xml +++ b/general/prog/gcc.xml @@ -1,6 +1,6 @@ - + -gcc-&gcc-version; +GCC-&gcc-version; &gnat-intro; &gnat-inst; diff --git a/general/prog/gcc/gcc-desc.xml b/general/prog/gcc/gcc-desc.xml index ef94b78265..bb47434168 100644 --- a/general/prog/gcc/gcc-desc.xml +++ b/general/prog/gcc/gcc-desc.xml @@ -1,7 +1,8 @@ Contents -The gcc package contains c++, +The GCC package contains +c++, c++filt, cpp, g++, g77, gcc, gccbug, @@ -19,51 +20,61 @@ Description The programs and libraries whose descriptions are missing here -have been described in the LFS gcc-&gcc-version; page. +have been described in the LFS +GCC-&gcc-version; page. g77 -g77 is the Fortran compiler invoked by gcc. +g77 is the Fortran compiler +invoked by gcc. add2line -add2line converts the ASCII form of the 2-line orbital elements in -a file to binary form and appends them to the orbdata files. +add2line converts the ASCII form of +the 2-line orbital elements in a file to binary form and appends them to the +orbdata files. gcov gcov is a test coverage program. gdb -gdb is the GNAT debugger. +gdb is the +GNAT debugger. gnatbind -gnatbind is used to bind compiled objects. +gnatbind is used to bind compiled objects. + gnatbl -gnatbl is the Ada linker. +gnatbl is the Ada linker. + gnatchop -gnatchop is useful for renaming files to meet the standard Ada -default file naming conventions. +gnatchop is useful for renaming files to meet the +standard Ada default file naming conventions. + gnatelim -gnatelim is used to detect and eliminate unused subprograms in an -Ada partition. +gnatelim is used to detect and eliminate unused +subprograms in an Ada partition. gnatfind -gnatfind is the GNAT definition/use finder. +gnatfind is the GNAT + definition/use finder. gnatgcc gnatgcc is the compiler. gnathtml.pl -gnathtml.pl converts Ada source files to html for viewing in Web -browsers. +gnathtml.pl converts +Ada source files to HTML for +viewing in Web browsers. gnatkr -gnatkr is used to determine the crunched name for a given file, -when crunched to a specified maximum length. +gnatkr is used to determine the crunched name for a +given file, when crunched to a specified maximum length. gnatlink -gnatlink is used to link programs and build an executable file. +gnatlink is used to link programs and build an +executable file. gnatls gnatls is the compiled unit browser. @@ -72,28 +83,32 @@ when crunched to a specified maximum length. gnatmake is an automatic make facility. gnatmem -gnatmem is the GNAT utility that monitors dynamic allocation and +gnatmem is the GNAT + utility that monitors dynamic allocation and deallocation activity in a program. gnatprep -gnatprep is the GNAT external preprocessor. +gnatprep is the +GNAT external preprocessor. + gnatpsta -gnatpsta determines the values of all the relevant parameters in -Standard and outputs to stdout. +gnatpsta determines the values of all the relevant +parameters in Standard and outputs to stdout. gnatpsys -gnatpsys determines the values of all the relevant parameters in -System and outputs to stdout. +gnatpsys determines the values of all the relevant +parameters in System and outputs to stdout. gnatstub gnatstub is a generator of body stubs. gnatxref -gnatxref is the GNAT cross-referencer. +gnatxref is the GNAT cross-referencer. gvd -gvd is the GNU Visual Debugger. +gvd is the GNU Visual Debugger. + diff --git a/general/prog/gcc/gcc-exp.xml b/general/prog/gcc/gcc-exp.xml index 169335c0d7..fdc2fb2c0f 100644 --- a/general/prog/gcc/gcc-exp.xml +++ b/general/prog/gcc/gcc-exp.xml @@ -6,31 +6,37 @@ stores your current path before it's modified so that it can be restored after installation. export PATH=/opt/gnat/bin:$PATH : This -command allows the build to find gnat's Ada compiler to build -Ada. +command allows the build to find +GNAT's +Ada compiler to build +Ada. touch treeprs.ads [es]info.h nmake.ad[bs] : -This command creates necessary files for the Ada build. This step -may be skipped if you don't want to compile the ada frontend. +This command creates necessary files for the +Ada build. This step +may be skipped if you don't want to compile the +Ada frontend. CC=/usr/bin/gcc : This command works around the -new PATH which puts gnat's -gcc as the primary compiler. +new PATH which puts GNAT +'s gcc as the primary compiler. --enable-languages=c,c++,objc,f77,ada,java -: This command builds all available languages in the gcc package. +: This command builds all available languages in the +GCC package. You may modify this command to remove unwanted languages. --enable-shared --enable-threads=posix --enable-__cxa_atexit : These commands are required to build -the C++ libraries to published standards. +the C++ libraries to published standards. --enable-clocale=gnu : This command is a failsafe for incomplete locale data. make gnatlib_and tools : This command -completes the Ada build process. Skip this step if you have not enabled -ADA as one of the languages. +completes the Ada build process. Skip this step if +you have not enabled Ada as one of the languages. + diff --git a/general/prog/gcc/gcc-inst.xml b/general/prog/gcc/gcc-inst.xml index 6b698cba3c..acc5210b76 100644 --- a/general/prog/gcc/gcc-inst.xml +++ b/general/prog/gcc/gcc-inst.xml @@ -1,10 +1,11 @@ -Installation of <application>gcc</application> +Installation of <application><acronym>GCC</acronym></application> Patch the source files with the following command: patch -Np1 -i ../gcc-3.3.1-no_fixincludes-2.patch -Install gcc by running the following commands: +Install GCC by running the +following commands: PATH_HOLD=$PATH && export PATH=/opt/gnat/bin:$PATH && @@ -22,7 +23,8 @@ make install && ln -sf g77 /usr/bin/f77 && export PATH=$PATH_HOLD -You may remove the gnat installation: +You may remove the GNAT +installation: rm -rf /opt/gnat diff --git a/general/prog/gcc/gcc-intro.xml b/general/prog/gcc/gcc-intro.xml index fef4065e68..dcad26be74 100644 --- a/general/prog/gcc/gcc-intro.xml +++ b/general/prog/gcc/gcc-intro.xml @@ -1,9 +1,12 @@ -Introduction to <application>gcc</application> +Introduction to <application><acronym>GCC</acronym></application> -The gcc package contains GNU compilers. This is useful for -compiling programs written in Ada, C, C++, Fortran, Java and Objective -C. +The GCC package +contains GNU compilers. This is useful for +compiling programs written in Ada, +C, C++, +Fortran, Java and +Objective C. Package information diff --git a/general/prog/gcc/gnat-inst.xml b/general/prog/gcc/gnat-inst.xml index fc326080ad..1ae19137d2 100644 --- a/general/prog/gcc/gnat-inst.xml +++ b/general/prog/gcc/gnat-inst.xml @@ -1,14 +1,15 @@ -Installation of <application>gnat</application> +Installation of <application><acronym>GNAT</acronym></application> -Install gnat by running the following commands: +Install GNAT by running the +following commands: ./doconfig The above script will ask you how and where you would like to install -gnat. To avoid conflicts with the system -gcc, the package will be installed -in a separate directory, that can later be removed from the system. +GNAT. To avoid conflicts with the +system gcc, the package will be installed in a separate +directory, that can later be removed from the system. In response to the questions asked by the doconfig script, enter @@ -19,15 +20,9 @@ second question. To finish the install, run ./doinstall -The gnat compiler can be invoked by -executing the gcc binary -installed by the above script. - +The GNAT compiler can be +invoked by executing the gcc binary installed by the above +script. diff --git a/general/prog/gcc/gnat-intro.xml b/general/prog/gcc/gnat-intro.xml index db583def32..9661ed0b53 100644 --- a/general/prog/gcc/gnat-intro.xml +++ b/general/prog/gcc/gnat-intro.xml @@ -1,13 +1,15 @@ -Introduction to <application>gnat</application> (binary version) +Introduction to <application><acronym>GNAT</acronym></application> +(binary version) -The gnat package contains a precompiled Ada compiler. -This package is used to satisfy the circular -dependency when you recompile gcc to include ada. +The GNAT package contains a +precompiled Ada compiler. This package is used to +satisfy the circular dependency when you recompile +GCC to include Ada. -You may skip installation of gnat if you do not want to recompile -gcc -with ada support. +You may skip installation of GNAT + if you do not want to recompile GCC + with Ada support. Package information @@ -25,7 +27,7 @@ url="&gnat-download-ftp;"/> -<application>gnat</application> dependencies +<application><acronym>GNAT</acronym></application> dependencies Required diff --git a/general/prog/gcc2.xml b/general/prog/gcc2.xml index 109cb3d733..6de0f3300f 100644 --- a/general/prog/gcc2.xml +++ b/general/prog/gcc2.xml @@ -1,6 +1,6 @@ - + -gcc-&gcc2-version; +GCC-&gcc2-version; &gcc2-intro; &gcc2-inst; diff --git a/general/prog/gcc2/gcc2-config.xml b/general/prog/gcc2/gcc2-config.xml index a30f518409..01e75a487e 100644 --- a/general/prog/gcc2/gcc2-config.xml +++ b/general/prog/gcc2/gcc2-config.xml @@ -1,21 +1,21 @@ -Configuring gcc +Configuring <application><acronym>GCC</acronym></application> Configuration Information &library-config; The instructions given above make compatibility symlinks that pre-compiled -packages in BLFS require. You may create additional compatibility links based on -your requirements. +packages in BLFS require. You may create additional +compatibility links based on your requirements. -If you only need the gcc-&gcc2-version; libraries, you may delete +If you only need the GCC-&gcc2-version; libraries, you may delete /opt/gcc-&gcc2-version;. -Whenever you need to use gcc-&gcc2-version; instead of you system installed compiler, -add /opt/gcc-&gcc2-version;/bin to the front of your -PATH or (preferably) set the CC environment variable before compiling the concerned -package. +Whenever you need to use GCC-&gcc2-version; instead of you system +installed compiler, add +/opt/gcc-&gcc2-version;/bin to the front of your PATH or (preferably) set the CC +environment variable before compiling the concerned package. diff --git a/general/prog/gcc2/gcc2-desc.xml b/general/prog/gcc2/gcc2-desc.xml index 27bd5a25e4..3d8f7570d5 100644 --- a/general/prog/gcc2/gcc2-desc.xml +++ b/general/prog/gcc2/gcc2-desc.xml @@ -1,11 +1,11 @@ Contents -The gcc-&gcc2-version; package contains the -gcc-&gcc2-version; C and C++ compilers -and gcc-&gcc2-version; -libstdc++.so that is required by some commercial and pre-compiled -packages. +The GCC-&gcc2-version; package contains the +gcc-&gcc2-version; C and +C++ compilers and GCC-&gcc2-version; +libstdc++.so that is required by some commercial and +pre-compiled packages. diff --git a/general/prog/gcc2/gcc2-inst.xml b/general/prog/gcc2/gcc2-inst.xml index c891758572..a48cc191d3 100644 --- a/general/prog/gcc2/gcc2-inst.xml +++ b/general/prog/gcc2/gcc2-inst.xml @@ -1,42 +1,44 @@ -Installation of gcc +Installation of <application><acronym>GCC</acronym></application> Apply the patches: -patch -Np1 -i ../gcc-&gcc2-version;-2.patch && +patch -Np1 -i ../gcc-&gcc2-version;-2.patch && patch -Np1 -i ../gcc-&gcc2-version;-no-fixinc.patch && -patch -Np1 -i ../gcc-&gcc2-version;-returntype-fix.patch +patch -Np1 -i ../gcc-&gcc2-version;-returntype-fix.patch -The gcc development team recommends building in a separate directory. +The GCC development team recommends building in a +separate directory. -mkdir ../gcc-build && -cd ../gcc-build +mkdir ../gcc-build && +cd ../gcc-build -Configure gcc to build the C and C++ compilers and enable the related C++ -options. -../gcc-&gcc2-version;/configure \ +Configure GCC to build the +C and C++ compilers and +enable the related C++ options. +../gcc-&gcc2-version;/configure \ --prefix=/opt/gcc-&gcc2-version; \ --enable-shared --enable-languages=c,c++ \ ---enable-threads=posix +--enable-threads=posix -Compile and install gcc: -make bootstrap && -make install +Compile and install GCC: +make bootstrap && +make install Make note of the library that is installed. -L=`find /opt/gcc-&gcc2-version;/lib -name "*libstdc++*.so" -type f` && -IL=`basename $L` +L=`find /opt/gcc-&gcc2-version;/lib -name "*libstdc++*.so" -type f` && +IL=`basename $L` -Move the C++ libraries to the standard lib directory to avoid having to -add /opt/gcc-&gcc2-version;/lib to -/etc/ld.so.conf. +Move the C++ libraries to the standard lib +directory to avoid having to add /opt/gcc-&gcc2-version;/lib + to /etc/ld.so.conf. -for i in /opt/gcc-&gcc2-version;/lib/*.so*; do mv -f $i /usr/lib; -ln -sf /usr/lib/`basename $i` /opt/gcc-&gcc2-version;/lib; done +for i in /opt/gcc-&gcc2-version;/lib/*.so*; do mv -f $i /usr/lib; +ln -sf /usr/lib/`basename $i` /opt/gcc-&gcc2-version;/lib; done Create symlinks required by commercial and precompiled packages. -ln -sf $IL /usr/lib/libstdc++-libc6.1-1.so.2 && +ln -sf $IL /usr/lib/libstdc++-libc6.1-1.so.2 && ln -sf $IL /usr/lib/libstdc++-libc6.2-2.so.3 && -ln -sf $IL /usr/lib/libstdc++-libc6.3-2.so.3 +ln -sf $IL /usr/lib/libstdc++-libc6.3-2.so.3 diff --git a/general/prog/gcc2/gcc2-intro.xml b/general/prog/gcc2/gcc2-intro.xml index 1da92b5dfc..60299a13cb 100644 --- a/general/prog/gcc2/gcc2-intro.xml +++ b/general/prog/gcc2/gcc2-intro.xml @@ -1,19 +1,33 @@ -Introduction to gcc-&gcc2-version; +Introduction to <application><acronym>GCC</acronym></application>-&gcc2-version; -Download location (FTP): -Version used: &gcc2-version; -Package size: &gcc2-size; -Estimated Disk space required: &gcc2-buildsize; -There are two reasons for installing gcc-&gcc2-version;. The first is that the kernel -developers have certified gcc-&gcc2-version; as the preferred compiler for compiling the -kernel. The other (and more compelling reason) is that some -commercial closed-source packages (such as Netscape Navigator, Yahoo Pager) -and precompiled packages (such as Mozilla) -are linked against gcc-&gcc2-version; libs. +There are two reasons for installing +GCC-&gcc2-version;. The first is that the kernel +developers have certified GCC-&gcc2-version; as the +preferred compiler for compiling the kernel. The other (and more compelling +reason) is that some commercial closed-source packages (such as Netscape +Navigator, Yahoo Pager) and precompiled packages (such as Mozilla) +are linked against GCC-&gcc2-version; libs. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gcc2-size; +Estimated Disk space required: +&gcc2-buildsize; +Estimated build time: +&gcc2-time; + + +Additional downloads + +Required patches: + + -Download the gcc patches from . - diff --git a/general/prog/gcc2/gcc2.ent b/general/prog/gcc2/gcc2.ent index 34560ba5b2..b22372cd7a 100644 --- a/general/prog/gcc2/gcc2.ent +++ b/general/prog/gcc2/gcc2.ent @@ -8,3 +8,4 @@ +