Ignore:
Timestamp:
05/16/2004 12:06:08 AM (20 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.0, 6.1, 6.1.1, 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:
a001133
Parents:
90a4897
Message:

HEAD: Retaged the SBUs/disk-usage sections, the lists of options and the contents sections in chapter05.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter05/binutils-pass1.xml

    r90a4897 r9652249  
    44  %general-entities;
    55]>
    6 <sect1 id="ch-tools-binutils-pass1">
     6<sect1 id="ch-tools-binutils-pass1" role="wrap">
    77<title>Binutils-&binutils-version; - Pass 1</title>
    88<?dbhtml filename="binutils-pass1.html"?>
    … …  
    1212<secondary>tools, pass 1</secondary></indexterm>
    1313
    14 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[1])"/>
     14<sect2 role="package"><title/>
     15<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1516
    16 <screen>&buildtime; 1.0 SBU
    17 &diskspace; 194 MB</screen>
     17<segmentedlist>
     18<segtitle>&buildtime;</segtitle>
     19<segtitle>&diskspace;</segtitle>
     20<seglistitem><seg>1.0 SBU</seg><seg>194 MB</seg></seglistitem>
     21</segmentedlist>
    1822
    19 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[2])"/>
     23<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2024
     25</sect2>
    2126
    22 <sect2>
     27<sect2 role="installation">
    2328<title>Installation of Binutils</title>
    2429
    … …  
    5257<para>The meaning of the configure options:</para>
    5358
    54 <itemizedlist>
    55 <listitem><para><userinput>--prefix=/tools</userinput>: This tells the
    56 configure script to prepare to install the Binutils programs in the
    57 <filename>/tools</filename> directory.</para></listitem>
     59<variablelist>
     60<varlistentry>
     61<term><userinput>--prefix=/tools</userinput></term>
     62<listitem><para>This tells the configure script to prepare to install the Binutils
     63programs in the <filename>/tools</filename> directory.</para></listitem>
     64</varlistentry>
    5865
    59 <listitem><para><userinput>--disable-nls</userinput>: This disables
    60 internationalization (a word often shortened to i18n). We don't need this
    61 for our static programs and <emphasis>nls</emphasis> often causes problems
    62 when linking statically.</para></listitem>
    63 </itemizedlist>
     66<varlistentry>
     67<term><userinput>--disable-nls</userinput></term>
     68<listitem><para>This disables internationalization (a word often shortened to
     69i18n). We don't need this for our static programs and <emphasis>nls</emphasis>
     70often causes problems when linking statically.</para></listitem>
     71</varlistentry>
     72</variablelist>
    6473
    6574<para>Continue with compiling the package:</para>
    … …  
    7079<para>The meaning of the make parameters:</para>
    7180
    72 <itemizedlist>
    73 <listitem><para><userinput>configure-host</userinput>: This forces all the
    74 subdirectories to be configured immediately. A statically linked build will
    75 fail without it. We therefore use this option to work around the
    76 problem.</para></listitem>
     81<variablelist>
     82<varlistentry>
     83<term><userinput>configure-host</userinput></term>
     84<listitem><para>This forces all the subdirectories to be configured immediately.
     85A statically linked build will fail without it. We therefore use this option to work
     86around the problem.</para></listitem>
     87</varlistentry>
    7788
    78 <listitem><para><userinput>LDFLAGS="-all-static"</userinput>: This tells the
    79 linker that all the Binutils programs should be linked statically. However,
    80 strictly speaking, <emphasis>"-all-static"</emphasis> is passed to the
    81 <command>libtool</command> program, which then passes
     89<varlistentry>
     90<term><userinput>LDFLAGS="-all-static"</userinput></term>
     91<listitem><para>This tells the linker that all the Binutils programs should be
     92linked statically. However, strictly speaking, <emphasis>"-all-static"</emphasis>
     93is passed to the <command>libtool</command> program, which then passes
    8294<emphasis>"-static"</emphasis> to the linker.</para></listitem>
    83 </itemizedlist>
     95</varlistentry>
     96</variablelist>
    8497
    8598<para>Compilation is complete. Normally we would now run the test suite, but
    … …  
    100113<para>The meaning of the make parameters:</para>
    101114
    102 <itemizedlist>
    103 <listitem><para><userinput>-C ld clean</userinput>: This tells the make program
    104 to remove all the compiled files in the <filename class="directory">ld</filename> subdirectory.</para></listitem>
     115<variablelist>
     116<varlistentry>
     117<term><userinput>-C ld clean</userinput></term>
     118<listitem><para>This tells the make program to remove all the compiled files
     119in the <filename class="directory">ld</filename> subdirectory.</para></listitem>
     120</varlistentry>
    105121
    106 <listitem><para><userinput>-C ld LDFLAGS="-all-static"
    107 LIB_PATH=/tools/lib</userinput>: This option rebuilds everything in the
     122<varlistentry>
     123<term><userinput>-C ld LDFLAGS="-all-static"
     124LIB_PATH=/tools/lib</userinput></term>
     125<listitem><para>This option rebuilds everything in the
    108126<filename class="directory">ld</filename> subdirectory. Specifying the LIB_PATH
    109127makefile variable on the command line allows us to override the default value
    … …  
    111129specifies the linker's default library search path. You will see how this
    112130preparation is used later on in the chapter.</para></listitem>
    113 </itemizedlist>
     131</varlistentry>
     132</variablelist>
    114133
    115134
    … …  
    121140</sect2>
    122141
    123 <sect2><title/>
     142<sect2 role="content"><title/>
    124143<para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
    125144</sect2>
Note: See TracChangeset for help on using the changeset viewer.