aboutsummaryrefslogtreecommitdiffstats
path: root/chapter05/gcc-pass1.xml
diff options
context:
space:
mode:
authorManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-20 21:02:23 +0000
committerManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-20 21:02:23 +0000
commit1f7ca93564b3dc065306bbe7ab9713bbce112cdd (patch)
tree898493c7048285dd389135094cb4a036fc26c36e /chapter05/gcc-pass1.xml
parent11cbbb04522b834acbb8e353c7fcc4b006c56b3d (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.xml184
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>