From 6a82dd9a1814badb87e18df165474a8b89a39b73 Mon Sep 17 00:00:00 2001 From: Manuel Canales Esparcia Date: Sat, 4 Feb 2006 13:28:41 +0000 Subject: Indenting chapter 6, part 5 git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7344 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter06/gcc.xml | 374 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 209 insertions(+), 165 deletions(-) (limited to 'chapter06/gcc.xml') diff --git a/chapter06/gcc.xml b/chapter06/gcc.xml index b67e4ede7..1611b2c59 100644 --- a/chapter06/gcc.xml +++ b/chapter06/gcc.xml @@ -1,217 +1,261 @@ - %general-entities; ]> + -GCC-&gcc-version; - + + + GCC-&gcc-version; + + + GCC + + + + -<indexterm zone="ch-system-gcc"><primary sortas="a-GCC">GCC</primary></indexterm> + <para>The GCC package contains the GNU compiler collection, which includes + the C and C++ compilers.</para> -<sect2 role="package"><title/> -<para>The GCC package contains the GNU compiler collection, which includes -the C and C++ compilers.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>11.7 SBU</seg><seg>451 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>11.7 SBU</seg> + <seg>451 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, Findutils, -Gawk, Gettext, Glibc, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of GCC + + Bash, Binutils, Coreutils, Diffutils, Findutils, Gawk, Gettext, + Glibc, Grep, Make, Perl, Sed, and Texinfo + + -Apply a sed substitution that will suppress the -installation of libiberty.a. The -version of libiberty.a provided by -Binutils will be used instead: + + + + Installation of GCC + + Apply a sed substitution that will suppress the + installation of libiberty.a. The + version of libiberty.a provided by + Binutils will be used instead: sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in -The bootstrap build performed in -built GCC with the compiler flag. -Non-bootstrap builds omit this flag by default, so apply the following -sed to use it in order to ensure consistent compiler builds. - + The bootstrap build performed in + built GCC with the compiler flag. + Non-bootstrap builds omit this flag by default, so apply the following + sed to use it in order to ensure consistent compiler + builds. sed -i 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in -The fixincludes script is known to occasionally -erroneously attempt to "fix" the system headers installed so far. As -the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known -to not require fixing, issue the following command to prevent the -fixincludes script from running: + The fixincludes script is known to occasionally + erroneously attempt to "fix" the system headers installed so far. As + the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known + to not require fixing, issue the following command to prevent the + fixincludes script from running: sed -i 's@\./fixinc\.sh@-c true@' gcc/Makefile.in -GCC provides a gccbug script which detects at -compile time whether mktemp is present, and hardcodes the result in a test. -This will cause the script to fall back to using less random names for -temporary files. We will be installing mktemp later, so the following sed -will simulate its presence. + GCC provides a gccbug script which detects at + compile time whether mktemp is present, and hardcodes the result in a test. + This will cause the script to fall back to using less random names for + temporary files. We will be installing mktemp later, so the following sed + will simulate its presence. sed -i 's/@have_mktemp_command@/yes/' gcc/gccbug.in -The GCC documentation recommends building GCC outside of the source -directory in a dedicated build directory: + The GCC documentation recommends building GCC outside of the source + directory in a dedicated build directory: mkdir -v ../gcc-build cd ../gcc-build -Prepare GCC for compilation: + Prepare GCC for compilation: ../gcc-&gcc-version;/configure --prefix=/usr \ --libexecdir=/usr/lib --enable-shared \ --enable-threads=posix --enable-__cxa_atexit \ --enable-clocale=gnu --enable-languages=c,c++ -Compile the package: + Compile the package: make -In this section, the test suite for GCC is considered -critical. Do not skip it under any circumstance. + + In this section, the test suite for GCC is considered + critical. Do not skip it under any circumstance. + -Test the results, but do not stop at errors: + Test the results, but do not stop at errors: make -k check -Some of the errors are known issues and were noted in the -previous chapter. The test suite notes from are still relevant here. Be sure to -refer back to them as necessary. + Some of the errors are known issues and were noted in the + previous chapter. The test suite notes from are still relevant here. Be sure to + refer back to them as necessary. -Install the package: + Install the package: make install -Some packages expect the C preprocessor to be installed in the -/lib directory. -To support those packages, create this symlink: + Some packages expect the C preprocessor to be installed in the + /lib directory. + To support those packages, create this symlink: ln -sv ../usr/bin/cpp /lib -Many packages use the name cc to call the C -compiler. To satisfy those packages, create a symlink: + Many packages use the name cc to call the C + compiler. To satisfy those packages, create a symlink: ln -sv gcc /usr/bin/cc -At this point, it is strongly recommended to repeat the -sanity check performed earlier in this chapter. Refer back to and repeat the check. If the results -are in error, then the most likely reason is that the GCC Specs patch -from was erroneously applied -here. - - - - -Contents of GCC - - -Installed programs -Installed libraries -c++, cc (link to gcc), cpp, g++, gcc, gccbug, and -gcov -libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and libsupc++.a - - -Short Descriptions - - - - -cc - -The C compiler -cc - - - - -cpp - -The C preprocessor; it is used by the compiler to expand the -#include, #define, and similar statements in the source files -cpp - - - - -c++ - -The C++ compiler -c++ - - - - -g++ - -The C++ compiler -g++ - - - - -gcc - -The C compiler -gcc - - - - -gccbug - -A shell script used to help create useful bug reports -gccbug - - - - -gcov - -A coverage testing tool; it is used to analyze programs to -determine where optimizations will have the most effect -gcov - - - - -libgcc - -Contains run-time support for gcc -libgcc* - - - - -libstdc++ - -The standard C++ library -libstdc++ - - - - -libsupc++ - -Provides supporting routines for the C++ programming language -libsupc++ - - - - - + + At this point, it is strongly recommended to repeat the sanity + check performed earlier in this chapter. Refer back to and repeat the check. If + the results are in error, then the most likely reason is that the GCC + Specs patch from was + erroneously applied here. + + + + + + Contents of GCC + + + Installed programs + Installed libraries + + + c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov + libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and + libsupc++.a + + + + + Short Descriptions + + + + + cc + + The C compiler + + cc + + + + + + cpp + + The C preprocessor; it is used by the compiler to expand the + #include, #define, and similar statements in the source files + + cpp + + + + + + c++ + + The C++ compiler + + c++ + + + + + + g++ + + The C++ compiler + + g++ + + + + + + gcc + + The C compiler + + gcc + + + + + + gccbug + + A shell script used to help create useful bug reports + + gccbug + + + + + + gcov + + A coverage testing tool; it is used to analyze programs to + determine where optimizations will have the most effect + + gcov + + + + + + libgcc + + Contains run-time support for gcc + + libgcc* + + + + + + libstdc++ + + The standard C++ library + + libstdc++ + + + + + + libsupc++ + + Provides supporting routines for the C++ programming + language + + libsupc++ + + + + + + + - -- cgit v1.2.3-54-g00ecf