Ignore:
Timestamp:
01/20/2006 09:02:23 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
e1d5f7b
Parents:
11cbbb0
Message:

Indenting chapter 05, part 3

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7286 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter05/gcc-pass1.xml

    r11cbbb0 r1f7ca93  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-gcc-pass1" role="wrap">
    7 <title>GCC-&gcc-version; - Pass 1</title>
    8 <?dbhtml filename="gcc-pass1.html"?>
     9  <?dbhtml filename="gcc-pass1.html"?>
    910
    10 <indexterm zone="ch-tools-gcc-pass1">
    11 <primary sortas="a-GCC">GCC</primary>
    12 <secondary>tools, pass 1</secondary></indexterm>
     11  <title>GCC-&gcc-version; - Pass 1</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-gcc-pass1">
     14    <primary sortas="a-GCC">GCC</primary>
     15    <secondary>tools, pass 1</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>4.4 SBU</seg><seg>219 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/gcc.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of GCC</title>
     29      <seglistitem>
     30        <seg>4.4 SBU</seg>
     31        <seg>219 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>The GCC documentation recommends building GCC outside of the
    31 source directory in a dedicated build directory:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/gcc.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of GCC</title>
     43
     44    <para>The GCC documentation recommends building GCC outside of the
     45    source directory in a dedicated build directory:</para>
    3246
    3347<screen><userinput>mkdir -v ../gcc-build
    3448cd ../gcc-build</userinput></screen>
    3549
    36 <para>Prepare GCC for compilation:</para>
     50    <para>Prepare GCC for compilation:</para>
    3751
    3852<screen><userinput>../gcc-&gcc-version;/configure --prefix=/tools \
    … …  
    4054    --enable-languages=c</userinput></screen>
    4155
    42 <para>The meaning of the configure options:</para>
     56    <variablelist>
     57      <title>The meaning of the configure options:</title>
    4358
    44 <variablelist>
    45 <varlistentry>
    46 <term><parameter>--with-local-prefix=/tools</parameter></term>
    47 <listitem><para>The purpose of this switch is to remove <filename class="directory">/usr/local/include</filename>
    48 from <command>gcc</command>'s include search path. This is not absolutely
    49 essential, however, it helps to minimize the influence of the host
    50 system.</para>
    51 </listitem>
    52 </varlistentry>
     59      <varlistentry>
     60        <term><parameter>--with-local-prefix=/tools</parameter></term>
     61        <listitem>
     62          <para>The purpose of this switch is to remove <filename
     63          class="directory">/usr/local/include</filename> from
     64          <command>gcc</command>'s include search path. This is not
     65          absolutely essential, however, it helps to minimize the
     66          influence of the host system.</para>
     67        </listitem>
     68      </varlistentry>
    5369
    54 <varlistentry>
    55 <term><parameter>--enable-shared</parameter></term>
    56 <listitem><para>This switch allows the building of
    57 <filename class="libraryfile">libgcc_s.so.1</filename> and
    58 <filename class="libraryfile">libgcc_eh.a</filename>.  Having
    59 <filename class="libraryfile">libgcc_eh.a</filename> available ensures that the
    60 configure script for Glibc (the next package we compile) produces the proper
    61 results.</para></listitem>
    62 </varlistentry>
     70      <varlistentry>
     71        <term><parameter>--enable-shared</parameter></term>
     72        <listitem>
     73          <para>This switch allows the building of <filename
     74          class="libraryfile">libgcc_s.so.1</filename> and
     75          <filename class="libraryfile">libgcc_eh.a</filename>.
     76          Having <filename class="libraryfile">libgcc_eh.a</filename>
     77          available ensures that the configure script for Glibc (the
     78          next package we compile) produces the proper results.</para>
     79        </listitem>
     80      </varlistentry>
    6381
    64 <varlistentry>
    65 <term><parameter>--enable-languages=c</parameter></term>
    66 <listitem><para>This option ensures that only the C compiler is built.
    67 </para></listitem>
    68 </varlistentry>
    69 </variablelist>
     82      <varlistentry>
     83        <term><parameter>--enable-languages=c</parameter></term>
     84        <listitem>
     85          <para>This option ensures that only the C compiler is built.</para>
     86        </listitem>
     87      </varlistentry>
    7088
    71 <para>Continue with compiling the package:</para>
     89    </variablelist>
     90
     91    <para>Continue with compiling the package:</para>
    7292
    7393<screen><userinput>make bootstrap</userinput></screen>
    7494
    75 <para>The meaning of the make parameters:</para>
     95    <variablelist>
     96      <title>The meaning of the make parameters:</title>
    7697
    77 <variablelist>
    78 <varlistentry>
    79 <term><parameter>bootstrap</parameter></term>
    80 <listitem><para>This target does not just compile GCC, but compiles it
    81 several times. It uses the programs compiled in a first round to
    82 compile itself a second time, and then again a third time. It then
    83 compares these second and third compiles to make sure it can reproduce
    84 itself flawlessly.  This also implies that it was compiled
    85 correctly.</para></listitem>
    86 </varlistentry>
    87 </variablelist>
     98      <varlistentry>
     99        <term><parameter>bootstrap</parameter></term>
     100        <listitem>
     101          <para>This target does not just compile GCC, but compiles it
     102          several times. It uses the programs compiled in a first round
     103          to compile itself a second time, and then again a third time.
     104          It then compares these second and third compiles to make sure
     105          it can reproduce itself flawlessly. This also implies that it
     106          was compiled correctly.</para>
     107        </listitem>
     108      </varlistentry>
    88109
    89 <para>Compilation is now complete. At this point, the test suite would
    90 normally be run, but, as mentioned before, the test suite framework is
    91 not in place yet. The benefits of running the tests at this point
    92 are minimal since the programs from this first pass will soon be
    93 replaced.</para>
     110    </variablelist>
    94111
    95 <para>Install the package:</para>
     112    <para>Compilation is now complete. At this point, the test suite would
     113    normally be run, but, as mentioned before, the test suite framework is
     114    not in place yet. The benefits of running the tests at this point
     115    are minimal since the programs from this first pass will soon be
     116    replaced.</para>
     117
     118    <para>Install the package:</para>
    96119
    97120<screen><userinput>make install</userinput></screen>
    98121
    99 <para>As a finishing touch, create a symlink. Many programs and
    100 scripts run <command>cc</command> instead of <command>gcc</command>, which is used to keep programs generic
    101 and therefore usable on all kinds of UNIX systems where the GNU C compiler
    102 is not always installed. Running <command>cc</command> leaves the system administrator
    103 free to decide which C compiler to install.</para>
     122    <para>As a finishing touch, create a symlink. Many programs and scripts
     123    run <command>cc</command> instead of <command>gcc</command>, which is
     124    used to keep programs generic and therefore usable on all kinds of UNIX
     125    systems where the GNU C compiler is not always installed. Running
     126    <command>cc</command> leaves the system administrator free to decide
     127    which C compiler to install.</para>
    104128
    105129<screen><userinput>ln -vs gcc /tools/bin/cc</userinput></screen>
    106130
    107 </sect2>
     131  </sect2>
    108132
    109 <sect2 role="content"><title/>
    110 <para>Details on this package are located in <xref
    111 linkend="contents-gcc" role="."/></para>
    112 </sect2>
     133  <sect2 role="content">
     134    <title/>
     135
     136    <para>Details on this package are located in
     137    <xref linkend="contents-gcc" role="."/></para>
     138
     139  </sect2>
    113140
    114141</sect1>
    115 
Note: See TracChangeset for help on using the changeset viewer.