diff options
author | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-01-20 21:02:23 +0000 |
---|---|---|
committer | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-01-20 21:02:23 +0000 |
commit | 1f7ca93564b3dc065306bbe7ab9713bbce112cdd (patch) | |
tree | 898493c7048285dd389135094cb4a036fc26c36e /chapter05/gcc-pass1.xml | |
parent | 11cbbb04522b834acbb8e353c7fcc4b006c56b3d (diff) |
Indenting chapter 05, part 3
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7286 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter05/gcc-pass1.xml')
-rw-r--r-- | chapter05/gcc-pass1.xml | 184 |
1 files changed, 105 insertions, 79 deletions
diff --git a/chapter05/gcc-pass1.xml b/chapter05/gcc-pass1.xml index d2989fa42..aa2ea3623 100644 --- a/chapter05/gcc-pass1.xml +++ b/chapter05/gcc-pass1.xml @@ -1,115 +1,141 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-tools-gcc-pass1" role="wrap"> -<title>GCC-&gcc-version; - Pass 1</title> -<?dbhtml filename="gcc-pass1.html"?> + <?dbhtml filename="gcc-pass1.html"?> + + <title>GCC-&gcc-version; - Pass 1</title> + + <indexterm zone="ch-tools-gcc-pass1"> + <primary sortas="a-GCC">GCC</primary> + <secondary>tools, pass 1</secondary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-tools-gcc-pass1"> -<primary sortas="a-GCC">GCC</primary> -<secondary>tools, pass 1</secondary></indexterm> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" + href="../chapter06/gcc.xml" + xpointer="xpointer(/sect1/sect2[1]/para[1])"/> -<sect2 role="package"><title/> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>4.4 SBU</seg><seg>219 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>4.4 SBU</seg> + <seg>219 MB</seg> + </seglistitem> + </segmentedlist> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" + href="../chapter06/gcc.xml" + xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> -</sect2> + </sect2> -<sect2 role="installation"> -<title>Installation of GCC</title> + <sect2 role="installation"> + <title>Installation of GCC</title> -<para>The GCC documentation recommends building GCC outside of the -source directory in a dedicated build directory:</para> + <para>The GCC documentation recommends building GCC outside of the + source directory in a dedicated build directory:</para> <screen><userinput>mkdir -v ../gcc-build cd ../gcc-build</userinput></screen> -<para>Prepare GCC for compilation:</para> + <para>Prepare GCC for compilation:</para> <screen><userinput>../gcc-&gcc-version;/configure --prefix=/tools \ --with-local-prefix=/tools --disable-nls --enable-shared \ --enable-languages=c</userinput></screen> -<para>The meaning of the configure options:</para> - -<variablelist> -<varlistentry> -<term><parameter>--with-local-prefix=/tools</parameter></term> -<listitem><para>The purpose of this switch is to remove <filename class="directory">/usr/local/include</filename> -from <command>gcc</command>'s include search path. This is not absolutely -essential, however, it helps to minimize the influence of the host -system.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><parameter>--enable-shared</parameter></term> -<listitem><para>This switch allows the building of -<filename class="libraryfile">libgcc_s.so.1</filename> and -<filename class="libraryfile">libgcc_eh.a</filename>. Having -<filename class="libraryfile">libgcc_eh.a</filename> available ensures that the -configure script for Glibc (the next package we compile) produces the proper -results.</para></listitem> -</varlistentry> - -<varlistentry> -<term><parameter>--enable-languages=c</parameter></term> -<listitem><para>This option ensures that only the C compiler is built. -</para></listitem> -</varlistentry> -</variablelist> - -<para>Continue with compiling the package:</para> + <variablelist> + <title>The meaning of the configure options:</title> + + <varlistentry> + <term><parameter>--with-local-prefix=/tools</parameter></term> + <listitem> + <para>The purpose of this switch is to remove <filename + class="directory">/usr/local/include</filename> from + <command>gcc</command>'s include search path. This is not + absolutely essential, however, it helps to minimize the + influence of the host system.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--enable-shared</parameter></term> + <listitem> + <para>This switch allows the building of <filename + class="libraryfile">libgcc_s.so.1</filename> and + <filename class="libraryfile">libgcc_eh.a</filename>. + Having <filename class="libraryfile">libgcc_eh.a</filename> + available ensures that the configure script for Glibc (the + next package we compile) produces the proper results.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--enable-languages=c</parameter></term> + <listitem> + <para>This option ensures that only the C compiler is built.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>Continue with compiling the package:</para> <screen><userinput>make bootstrap</userinput></screen> -<para>The meaning of the make parameters:</para> + <variablelist> + <title>The meaning of the make parameters:</title> -<variablelist> -<varlistentry> -<term><parameter>bootstrap</parameter></term> -<listitem><para>This target does not just compile GCC, but compiles it -several times. It uses the programs compiled in a first round to -compile itself a second time, and then again a third time. It then -compares these second and third compiles to make sure it can reproduce -itself flawlessly. This also implies that it was compiled -correctly.</para></listitem> -</varlistentry> -</variablelist> + <varlistentry> + <term><parameter>bootstrap</parameter></term> + <listitem> + <para>This target does not just compile GCC, but compiles it + several times. It uses the programs compiled in a first round + to compile itself a second time, and then again a third time. + It then compares these second and third compiles to make sure + it can reproduce itself flawlessly. This also implies that it + was compiled correctly.</para> + </listitem> + </varlistentry> -<para>Compilation is now complete. At this point, the test suite would -normally be run, but, as mentioned before, the test suite framework is -not in place yet. The benefits of running the tests at this point -are minimal since the programs from this first pass will soon be -replaced.</para> + </variablelist> -<para>Install the package:</para> + <para>Compilation is now complete. At this point, the test suite would + normally be run, but, as mentioned before, the test suite framework is + not in place yet. The benefits of running the tests at this point + are minimal since the programs from this first pass will soon be + replaced.</para> + + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para>As a finishing touch, create a symlink. Many programs and -scripts run <command>cc</command> instead of <command>gcc</command>, which is used to keep programs generic -and therefore usable on all kinds of UNIX systems where the GNU C compiler -is not always installed. Running <command>cc</command> leaves the system administrator -free to decide which C compiler to install.</para> + <para>As a finishing touch, create a symlink. Many programs and scripts + run <command>cc</command> instead of <command>gcc</command>, which is + used to keep programs generic and therefore usable on all kinds of UNIX + systems where the GNU C compiler is not always installed. Running + <command>cc</command> leaves the system administrator free to decide + which C compiler to install.</para> <screen><userinput>ln -vs gcc /tools/bin/cc</userinput></screen> -</sect2> + </sect2> -<sect2 role="content"><title/> -<para>Details on this package are located in <xref -linkend="contents-gcc" role="."/></para> -</sect2> + <sect2 role="content"> + <title/> -</sect1> + <para>Details on this package are located in + <xref linkend="contents-gcc" role="."/></para> + </sect2> + +</sect1> |