gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-22 21:29:23 +01:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3600 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2004-05-16 00:06:08 +00:00
parent 90a48977b4
commit 965224946e
31 changed files with 613 additions and 339 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
chapter05/bash.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-bash"> <sect1 id="ch-tools-bash" role="wrap">
<title>Bash-&bash-version;</title> <title>Bash-&bash-version;</title>
<?dbhtml filename="bash.html"?> <?dbhtml filename="bash.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Bash">Bash</primary> <primary sortas="a-Bash">Bash</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bash.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bash.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 1.2 SBU <segmentedlist>
&diskspace; 27 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.2 SBU</seg><seg>27 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bash.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bash.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Bash</title> <title>Installation of Bash</title>
<para>Bash contains several known bugs. Fix these with the following <para>Bash contains several known bugs. Fix these with the following
@ -49,7 +54,7 @@ for a shell:</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-bash"/>.</para> <para>The details on this package are found in <xref linkend="contents-bash"/>.</para>
</sect2> </sect2>

83
chapter05/binutils-pass1.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-binutils-pass1"> <sect1 id="ch-tools-binutils-pass1" role="wrap">
<title>Binutils-&binutils-version; - Pass 1</title> <title>Binutils-&binutils-version; - Pass 1</title>
<?dbhtml filename="binutils-pass1.html"?> <?dbhtml filename="binutils-pass1.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Binutils">Binutils</primary> <primary sortas="a-Binutils">Binutils</primary>
<secondary>tools, pass 1</secondary></indexterm> <secondary>tools, pass 1</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 1.0 SBU <segmentedlist>
&diskspace; 194 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.0 SBU</seg><seg>194 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Binutils</title> <title>Installation of Binutils</title>
<para>It is important that Binutils be the first package to get compiled, <para>It is important that Binutils be the first package to get compiled,
@ -51,16 +56,20 @@ like this: <userinput>time { ./configure ... &amp;&amp; ... &amp;&amp; ...
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--prefix=/tools</userinput>: This tells the <varlistentry>
configure script to prepare to install the Binutils programs in the <term><userinput>--prefix=/tools</userinput></term>
<filename>/tools</filename> directory.</para></listitem> <listitem><para>This tells the configure script to prepare to install the Binutils
programs in the <filename>/tools</filename> directory.</para></listitem>
</varlistentry>
<listitem><para><userinput>--disable-nls</userinput>: This disables <varlistentry>
internationalization (a word often shortened to i18n). We don't need this <term><userinput>--disable-nls</userinput></term>
for our static programs and <emphasis>nls</emphasis> often causes problems <listitem><para>This disables internationalization (a word often shortened to
when linking statically.</para></listitem> i18n). We don't need this for our static programs and <emphasis>nls</emphasis>
</itemizedlist> often causes problems when linking statically.</para></listitem>
</varlistentry>
</variablelist>
<para>Continue with compiling the package:</para> <para>Continue with compiling the package:</para>
@ -69,18 +78,22 @@ make LDFLAGS="-all-static"</userinput></screen>
<para>The meaning of the make parameters:</para> <para>The meaning of the make parameters:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>configure-host</userinput>: This forces all the <varlistentry>
subdirectories to be configured immediately. A statically linked build will <term><userinput>configure-host</userinput></term>
fail without it. We therefore use this option to work around the <listitem><para>This forces all the subdirectories to be configured immediately.
problem.</para></listitem> A statically linked build will fail without it. We therefore use this option to work
around the problem.</para></listitem>
</varlistentry>
<listitem><para><userinput>LDFLAGS="-all-static"</userinput>: This tells the <varlistentry>
linker that all the Binutils programs should be linked statically. However, <term><userinput>LDFLAGS="-all-static"</userinput></term>
strictly speaking, <emphasis>"-all-static"</emphasis> is passed to the <listitem><para>This tells the linker that all the Binutils programs should be
<command>libtool</command> program, which then passes linked statically. However, strictly speaking, <emphasis>"-all-static"</emphasis>
is passed to the <command>libtool</command> program, which then passes
<emphasis>"-static"</emphasis> to the linker.</para></listitem> <emphasis>"-static"</emphasis> to the linker.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compilation is complete. Normally we would now run the test suite, but <para>Compilation is complete. Normally we would now run the test suite, but
at this early stage the test suite framework (Tcl, Expect and DejaGnu) is not at this early stage the test suite framework (Tcl, Expect and DejaGnu) is not
@ -99,18 +112,24 @@ make -C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput></screen>
<para>The meaning of the make parameters:</para> <para>The meaning of the make parameters:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>-C ld clean</userinput>: This tells the make program <varlistentry>
to remove all the compiled files in the <filename class="directory">ld</filename> subdirectory.</para></listitem> <term><userinput>-C ld clean</userinput></term>
<listitem><para>This tells the make program to remove all the compiled files
in the <filename class="directory">ld</filename> subdirectory.</para></listitem>
</varlistentry>
<listitem><para><userinput>-C ld LDFLAGS="-all-static" <varlistentry>
LIB_PATH=/tools/lib</userinput>: This option rebuilds everything in the <term><userinput>-C ld LDFLAGS="-all-static"
LIB_PATH=/tools/lib</userinput></term>
<listitem><para>This option rebuilds everything in the
<filename class="directory">ld</filename> subdirectory. Specifying the LIB_PATH <filename class="directory">ld</filename> subdirectory. Specifying the LIB_PATH
makefile variable on the command line allows us to override the default value makefile variable on the command line allows us to override the default value
and have it point to our temporary tools location. The value of this variable and have it point to our temporary tools location. The value of this variable
specifies the linker's default library search path. You will see how this specifies the linker's default library search path. You will see how this
preparation is used later on in the chapter.</para></listitem> preparation is used later on in the chapter.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<warning><para><emphasis>Do not yet remove</emphasis> the Binutils build and <warning><para><emphasis>Do not yet remove</emphasis> the Binutils build and
@ -120,7 +139,7 @@ further on in this chapter.</para></warning>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-binutils"/>.</para> <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
</sect2> </sect2>

32
chapter05/binutils-pass2.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-binutils-pass2"> <sect1 id="ch-tools-binutils-pass2" role="wrap">
<title>Binutils-&binutils-version; - Pass 2</title> <title>Binutils-&binutils-version; - Pass 2</title>
<?dbhtml filename="binutils-pass2.html"?> <?dbhtml filename="binutils-pass2.html"?>
@ -11,11 +11,17 @@
<primary sortas="a-Binutils">Binutils</primary> <primary sortas="a-Binutils">Binutils</primary>
<secondary>tools, pass 2</secondary></indexterm> <secondary>tools, pass 2</secondary></indexterm>
<screen>&buildtime; 1.5 SBU <sect2 role="package"><title/>
&diskspace; 108 MB</screen>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.5 SBU</seg><seg>108 MB</seg></seglistitem>
</segmentedlist>
<sect2> </sect2>
<sect2 role="installation">
<title>Re-installation of Binutils</title> <title>Re-installation of Binutils</title>
<para>Create a separate build directory again:</para> <para>Create a separate build directory again:</para>
@ -30,13 +36,15 @@ cd ../binutils-build</userinput></screen>
<para>The meaning of the new configure option:</para> <para>The meaning of the new configure option:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--with-lib-path=/tools/lib</userinput>: This tells <varlistentry>
the configure script to specify the library search path during the compilation <term><userinput>--with-lib-path=/tools/lib</userinput></term>
of Binutils, resulting in <emphasis>/tools/lib</emphasis> to be passed to the <listitem><para>This tells the configure script to specify the library search path
linker. This prevents the linker from searching through library directories on during the compilation of Binutils, resulting in <emphasis>/tools/lib</emphasis>
the host.</para></listitem> to be passed to the linker. This prevents the linker from searching through library
</itemizedlist> directories on the host.</para></listitem>
</varlistentry>
</variablelist>
<para>Before starting to build Binutils, remember to unset any environment <para>Before starting to build Binutils, remember to unset any environment
variables that override the default optimization flags.</para> variables that override the default optimization flags.</para>
@ -88,7 +96,7 @@ in the state they are in now.</para></warning>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-binutils"/>.</para> <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para>
</sect2> </sect2>

19
chapter05/bison.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-bison" xreflabel="Bison"> <sect1 id="ch-tools-bison" xreflabel="Bison" role="wrap">
<title>Bison-&bison-version;</title> <title>Bison-&bison-version;</title>
<?dbhtml filename="bison.html"?> <?dbhtml filename="bison.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Bison">Bison</primary> <primary sortas="a-Bison">Bison</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bison.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bison.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.6 SBU <segmentedlist>
&diskspace; 10.6 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.6 SBU</seg><seg>10.6 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bison.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bison.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Bison</title> <title>Installation of Bison</title>
<para>Prepare Bison for compilation:</para> <para>Prepare Bison for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-bison"/>.</para> <para>The details on this package are found in <xref linkend="contents-bison"/>.</para>
</sect2> </sect2>

19
chapter05/bzip2.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-bzip2"> <sect1 id="ch-tools-bzip2" role="wrap">
<title>Bzip2-&bzip2-version;</title> <title>Bzip2-&bzip2-version;</title>
<?dbhtml filename="bzip2.html"?> <?dbhtml filename="bzip2.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Bzip2">Bzip2</primary> <primary sortas="a-Bzip2">Bzip2</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 2.5 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.5 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Bzip2</title> <title>Installation of Bzip2</title>
<para>The Bzip2 package doesn't contain a <command>configure</command> <para>The Bzip2 package doesn't contain a <command>configure</command>
@ -33,7 +38,7 @@ script. Compile it with a straightforward:</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-bzip2"/>.</para> <para>The details on this package are found in <xref linkend="contents-bzip2"/>.</para>
</sect2> </sect2>

19
chapter05/coreutils.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-coreutils"> <sect1 id="ch-tools-coreutils" role="wrap">
<title>Coreutils-&coreutils-version;</title> <title>Coreutils-&coreutils-version;</title>
<?dbhtml filename="coreutils.html"?> <?dbhtml filename="coreutils.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Coreutils">Coreutils</primary> <primary sortas="a-Coreutils">Coreutils</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.9 SBU <segmentedlist>
&diskspace; 69 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.9 SBU</seg><seg>69 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Coreutils</title> <title>Installation of Coreutils</title>
<para>Prepare Coreutils for compilation:</para> <para>Prepare Coreutils for compilation:</para>
@ -57,7 +62,7 @@ platforms but generally are not a problem on Linux.)</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-coreutils"/>.</para> <para>The details on this package are found in <xref linkend="contents-coreutils"/>.</para>
</sect2> </sect2>

42
chapter05/dejagnu.xml
View File

@ -3,23 +3,29 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-dejagnu" xreflabel="DejaGnu"> <sect1 id="ch-tools-dejagnu" xreflabel="DejaGnu" role="wrap">
<title>DejaGnu-&dejagnu-version;</title> <title>DejaGnu-&dejagnu-version;</title>
<?dbhtml filename="dejagnu.html"?> <?dbhtml filename="dejagnu.html"?>
<indexterm zone="ch-tools-dejagnu"><primary sortas="a-DejaGnu">DejaGnu</primary></indexterm> <indexterm zone="ch-tools-dejagnu"><primary sortas="a-DejaGnu">DejaGnu</primary></indexterm>
<sect2 role="package"><title/>
<para>The DejaGnu package contains a framework for testing other programs.</para> <para>The DejaGnu package contains a framework for testing other programs.</para>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 8.6 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>8.6 MB</seg></seglistitem>
</segmentedlist>
<para>For its installation Dejagnu depends on: Bash, Binutils, Coreutils, Diffutils, <segmentedlist>
GCC, Glibc, Grep, Make, Sed.</para> <segtitle>Dejagnu installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<sect2>
<title>Installation of DejaGnu</title> <title>Installation of DejaGnu</title>
<para>Prepare DejaGnu for compilation:</para> <para>Prepare DejaGnu for compilation:</para>
@ -33,18 +39,24 @@ GCC, Glibc, Grep, Make, Sed.</para>
</sect2> </sect2>
<sect2 id="contents-dejagnu"><title>Contents of DejaGnu</title> <sect2 id="contents-dejagnu" role="content"><title>Contents of DejaGnu</title>
<para><emphasis>Installed program</emphasis>: runtest</para> <segmentedlist>
<segtitle>Installed program</segtitle>
<seglistitem><seg>runtest</seg></seglistitem>
</segmentedlist>
</sect2> <variablelist><title>Short description</title>
<sect2><title>Short description</title>
<varlistentry>
<term id="runtest"><command>rutest</command></term>
<listitem>
<indexterm zone="ch-tools-dejagnu runtest"><primary sortas="b-runtest">runtest</primary></indexterm> <indexterm zone="ch-tools-dejagnu runtest"><primary sortas="b-runtest">runtest</primary></indexterm>
<para id="runtest"><command>runtest</command> is the wrapper script that finds the proper <para>is the wrapper script that finds the proper
expect shell and then runs DejaGnu.</para> expect shell and then runs DejaGnu.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2> </sect2>

19
chapter05/diffutils.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-diffutils"> <sect1 id="ch-tools-diffutils" role="wrap">
<title>Diffutils-&diffutils-version;</title> <title>Diffutils-&diffutils-version;</title>
<?dbhtml filename="diffutils.html"?> <?dbhtml filename="diffutils.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Diffutils">Diffutils</primary> <primary sortas="a-Diffutils">Diffutils</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 7.5 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>7.5 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/diffutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Diffutils</title> <title>Installation of Diffutils</title>
<para>Prepare Diffutils for compilation:</para> <para>Prepare Diffutils for compilation:</para>
@ -36,7 +41,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-diffutils"/>.</para> <para>The details on this package are found in <xref linkend="contents-diffutils"/>.</para>
</sect2> </sect2>

68
chapter05/expect.xml
View File

@ -3,24 +3,30 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-expect" xreflabel="Expect"> <sect1 id="ch-tools-expect" xreflabel="Expect" role="wrap">
<title>Expect-&expect-version;</title> <title>Expect-&expect-version;</title>
<?dbhtml filename="expect.html"?> <?dbhtml filename="expect.html"?>
<indexterm zone="ch-tools-expect"><primary sortas="a-Expect">Expect</primary></indexterm> <indexterm zone="ch-tools-expect"><primary sortas="a-Expect">Expect</primary></indexterm>
<sect2 role="package"><title/>
<para>The Expect package contains a program for doing scripted dialogues with <para>The Expect package contains a program for doing scripted dialogues with
other interactive programs.</para> other interactive programs.</para>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 3.9 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>3.9 MB</seg></seglistitem>
</segmentedlist>
<para>Expect installation depends on: Bash, Binutils, Coreutils, Diffutils, <segmentedlist>
GCC, Glibc, Grep, Make, Sed, Tcl.</para> <segtitle>Expect installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed, Tcl</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<sect2>
<title>Installation of Expect</title> <title>Installation of Expect</title>
<para>First fix a bug that can result in bogus failures during the GCC test <para>First fix a bug that can result in bogus failures during the GCC test
@ -34,16 +40,22 @@ suite run:</para>
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--with-tcl=/tools/lib</userinput>: This ensures that <varlistentry>
<term><userinput>--with-tcl=/tools/lib</userinput></term>
<listitem><para>This ensures that
the configure script finds the Tcl installation in our temporary tools location. the configure script finds the Tcl installation in our temporary tools location.
We don't want it to find an existing one that may possibly reside on the host We don't want it to find an existing one that may possibly reside on the host
system.</para></listitem> system.</para></listitem>
</varlistentry>
<listitem><para><userinput>--with-x=no</userinput>: This tells the configure <varlistentry>
<term><userinput>--with-x=no</userinput></term>
<listitem><para>This tells the configure
script not to search for Tk (the Tcl GUI component) or the X Window System script not to search for Tk (the Tcl GUI component) or the X Window System
libraries, both of which may possibly reside on the host system.</para></listitem> libraries, both of which may possibly reside on the host system.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Build the package:</para> <para>Build the package:</para>
@ -61,30 +73,38 @@ considered critical.)</para>
<para>The meaning of the make parameter:</para> <para>The meaning of the make parameter:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>SCRIPTS=""</userinput>: This prevents installation <varlistentry>
<term><userinput>SCRIPTS=""</userinput></term>
<listitem><para>This prevents installation
of the supplementary expect scripts which are not needed.</para></listitem> of the supplementary expect scripts which are not needed.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>You can now remove the source directories of both Tcl and Expect.</para> <para>You can now remove the source directories of both Tcl and Expect.</para>
</sect2> </sect2>
<sect2 id="contents-expect"><title>Contents of Expect</title> <sect2 id="contents-expect" role="content"><title>Contents of Expect</title>
<para><emphasis>Installed program</emphasis>: expect</para> <segmentedlist>
<segtitle>Installed program</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>expect</seg><seg>libexpect&expect-version;.a</seg></seglistitem>
</segmentedlist>
<para><emphasis>Installed library</emphasis>: libexpect&expect-version;.a</para> <variablelist><title>Short description</title>
</sect2>
<sect2><title>Short description</title>
<varlistentry>
<term id="expect"><command>expect</command></term>
<listitem>
<indexterm zone="ch-tools-expect expect"><primary sortas="b-expect">expect</primary></indexterm> <indexterm zone="ch-tools-expect expect"><primary sortas="b-expect">expect</primary></indexterm>
<para id="expect"><command>expect</command> <quote>talks</quote> to other interactive <para><quote>talks</quote> to other interactive
programs according to a script.</para> programs according to a script.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2> </sect2>

19
chapter05/findutils.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-findutils"> <sect1 id="ch-tools-findutils" role="wrap">
<title>Findutils-&findutils-version;</title> <title>Findutils-&findutils-version;</title>
<?dbhtml filename="findutils.html"?> <?dbhtml filename="findutils.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Findutils">Findutils</primary> <primary sortas="a-Findutils">Findutils</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 7.6 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>7.6 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/findutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Findutils</title> <title>Installation of Findutils</title>
<para>Prepare Findutils for compilation:</para> <para>Prepare Findutils for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-findutils"/>.</para> <para>The details on this package are found in <xref linkend="contents-findutils"/>.</para>
</sect2> </sect2>

19
chapter05/flex.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-flex" xreflabel="Flex"> <sect1 id="ch-tools-flex" xreflabel="Flex" role="wrap">
<title>Flex-&flex-version;</title> <title>Flex-&flex-version;</title>
<?dbhtml filename="flex.html"?> <?dbhtml filename="flex.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Flex">Flex</primary> <primary sortas="a-Flex">Flex</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.6 SBU <segmentedlist>
&diskspace; 10.6 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.6 SBU</seg><seg>10.6 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/flex.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Bison</title> <title>Installation of Bison</title>
<para>Flex contains several known bugs. Fix these with the following patch:</para> <para>Flex contains several known bugs. Fix these with the following patch:</para>
@ -50,7 +55,7 @@ get renegerated:</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-flex"/>.</para> <para>The details on this package are found in <xref linkend="contents-flex"/>.</para>
</sect2> </sect2>

19
chapter05/gawk.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gawk"> <sect1 id="ch-tools-gawk" role="wrap">
<title>Gawk-&gawk-version;</title> <title>Gawk-&gawk-version;</title>
<?dbhtml filename="gawk.html"?> <?dbhtml filename="gawk.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Gawk">Gawk</primary> <primary sortas="a-Gawk">Gawk</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 17 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>17 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gawk.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Gawk</title> <title>Installation of Gawk</title>
<para>Prepare Gawk for compilation:</para> <para>Prepare Gawk for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-gawk"/>.</para> <para>The details on this package are found in <xref linkend="contents-gawk"/>.</para>
</sect2> </sect2>

54
chapter05/gcc-pass1.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gcc-pass1"> <sect1 id="ch-tools-gcc-pass1" role="wrap">
<title>GCC-&gcc-version; - Pass 1</title> <title>GCC-&gcc-version; - Pass 1</title>
<?dbhtml filename="gcc-pass1.html"?> <?dbhtml filename="gcc-pass1.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-GCC">GCC</primary> <primary sortas="a-GCC">GCC</primary>
<secondary>tools, pass 1</secondary></indexterm> <secondary>tools, pass 1</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/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])"/>
<screen>&buildtime; 4.4 SBU <segmentedlist>
&diskspace; 300 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>4.4 SBU</seg><seg>300 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/para[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> <title>Installation of GCC</title>
<para>Unpack only the GCC-core tarball, as we won't be needing the C++ compiler <para>Unpack only the GCC-core tarball, as we won't be needing the C++ compiler
@ -45,14 +50,18 @@ cd ../gcc-build</userinput></screen>
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--with-local-prefix=/tools</userinput>: The <varlistentry>
purpose of this switch is to remove <filename>/usr/local/include</filename> <term><userinput>--with-local-prefix=/tools</userinput></term>
<listitem><para>The purpose of this switch is to remove <filename>/usr/local/include</filename>
from <command>gcc</command>'s include search path. This is not absolutely from <command>gcc</command>'s include search path. This is not absolutely
essential; however, we want to try to minimize the influence of the host essential; however, we want to try to minimize the influence of the host
system, so this a sensible thing to do.</para></listitem> system, so this a sensible thing to do.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-shared</userinput>: This switch may <varlistentry>
<term><userinput>--enable-shared</userinput></term>
<listitem><para>This switch may
seem counter-intuitive at first. But using it allows the building of seem counter-intuitive at first. But using it allows the building of
<filename>libgcc_s.so.1</filename> and <filename>libgcc_eh.a</filename>, and <filename>libgcc_s.so.1</filename> and <filename>libgcc_eh.a</filename>, and
having <filename>libgcc_eh.a</filename> available ensures that the configure having <filename>libgcc_eh.a</filename> available ensures that the configure
@ -60,11 +69,15 @@ script for Glibc (the next package we compile) produces the proper results.
Note that the <command>gcc</command> binaries will still be linked Note that the <command>gcc</command> binaries will still be linked
statically, as this is controlled by the <emphasis>-static</emphasis> statically, as this is controlled by the <emphasis>-static</emphasis>
value of BOOT_LDFLAGS in the next step.</para></listitem> value of BOOT_LDFLAGS in the next step.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-languages=c</userinput>: This option <varlistentry>
<term><userinput>--enable-languages=c</userinput></term>
<listitem><para>This option
ensures that only the C compiler is built. The option is only needed when you ensures that only the C compiler is built. The option is only needed when you
have downloaded and unpacked the full GCC tarball.</para></listitem> have downloaded and unpacked the full GCC tarball.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Continue with compiling the package:</para> <para>Continue with compiling the package:</para>
@ -72,17 +85,22 @@ have downloaded and unpacked the full GCC tarball.</para></listitem>
<para>The meaning of the make parameters:</para> <para>The meaning of the make parameters:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>BOOT_LDFLAGS="-static"</userinput>: This tells <varlistentry>
GCC to link its programs statically.</para></listitem> <term><userinput>BOOT_LDFLAGS="-static"</userinput></term>
<listitem><para>This tells GCC to link its programs statically.</para></listitem>
</varlistentry>
<listitem><para><userinput>bootstrap</userinput>: This target doesn't just <varlistentry>
<term><userinput>bootstrap</userinput></term>
<listitem><para>This target doesn't just
compile GCC, but compiles it several times. It uses the programs compiled in 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. 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 It then compares these second and third compiles to make sure it can
reproduce itself flawlessly, which most probably means that it was reproduce itself flawlessly, which most probably means that it was
compiled correctly.</para></listitem> compiled correctly.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compilation is now complete, and at this point we would normally run the <para>Compilation is now complete, and at this point we would normally run the
test suite. But, as mentioned before, the test suite framework is not in place test suite. But, as mentioned before, the test suite framework is not in place
@ -104,7 +122,7 @@ C compiler to install, as long as there's a symlink pointing to it:</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-gcc"/>.</para> <para>The details on this package are found in <xref linkend="contents-gcc"/>.</para>
</sect2> </sect2>

45
chapter05/gcc-pass2.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gcc-pass2"> <sect1 id="ch-tools-gcc-pass2" role="wrap">
<title>GCC-&gcc-version; - Pass 2</title> <title>GCC-&gcc-version; - Pass 2</title>
<?dbhtml filename="gcc-pass2.html"?> <?dbhtml filename="gcc-pass2.html"?>
@ -11,11 +11,17 @@
<primary sortas="a-GCC">GCC</primary> <primary sortas="a-GCC">GCC</primary>
<secondary>tools, pass 2</secondary></indexterm> <secondary>tools, pass 2</secondary></indexterm>
<screen>&buildtime; 11.0 SBU <sect2 role="package"><title/>
&diskspace; 274 MB</screen>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.0 SBU</seg><seg>274 MB</seg></seglistitem>
</segmentedlist>
<sect2> </sect2>
<sect2 role="installation">
<title>Re-installation of GCC</title> <title>Re-installation of GCC</title>
<para>The tools required to test GCC and Binutils are installed now: Tcl, <para>The tools required to test GCC and Binutils are installed now: Tcl,
@ -90,32 +96,47 @@ variables that override the default optimization flags.</para>
<para>The meaning of the new configure options:</para> <para>The meaning of the new configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--enable-clocale=gnu</userinput>: This option <varlistentry>
<term><userinput>--enable-clocale=gnu</userinput></term>
<listitem><para>This option
ensures the correct locale model is selected for the C++ libraries under all ensures the correct locale model is selected for the C++ libraries under all
circumstances. If the configure script finds the <emphasis>de_DE</emphasis> circumstances. If the configure script finds the <emphasis>de_DE</emphasis>
locale installed, it will select the correct <emphasis>gnu</emphasis> locale locale installed, it will select the correct <emphasis>gnu</emphasis> locale
model. However, people who don't install the <emphasis>de_DE</emphasis> locale model. However, people who don't install the <emphasis>de_DE</emphasis> locale
would run the risk of building ABI incompatible C++ libraries due to the wrong would run the risk of building ABI incompatible C++ libraries due to the wrong
<emphasis>generic</emphasis> locale model being selected.</para></listitem> <emphasis>generic</emphasis> locale model being selected.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-threads=posix</userinput>: This enables <varlistentry>
<term><userinput>--enable-threads=posix</userinput></term>
<listitem><para>This enables
C++ exception handling for multi-threaded code.</para></listitem> C++ exception handling for multi-threaded code.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-__cxa_atexit</userinput>: This option <varlistentry>
<term><userinput>--enable-__cxa_atexit</userinput></term>
<listitem><para>This option
allows use of __cxa_atexit, rather than atexit, to register C++ destructors for allows use of __cxa_atexit, rather than atexit, to register C++ destructors for
local statics and global objects and is essential for fully standards-compliant local statics and global objects and is essential for fully standards-compliant
handling of destructors. It also affects the C++ ABI and therefore results in handling of destructors. It also affects the C++ ABI and therefore results in
C++ shared libraries and C++ programs that are interoperable with other Linux C++ shared libraries and C++ programs that are interoperable with other Linux
distributions.</para></listitem> distributions.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-languages=c,c++</userinput>: This option <varlistentry>
<term><userinput>--enable-languages=c,c++</userinput></term>
<listitem><para>This option
ensures that both the C and C++ compilers are built.</para></listitem> ensures that both the C and C++ compilers are built.</para></listitem>
</varlistentry>
<listitem><para><userinput>--disable-libstdcxx-pch</userinput>: Don't build the <varlistentry>
<term><userinput>--disable-libstdcxx-pch</userinput></term>
<listitem><para>Don't build the
PCH (pre-compiled header) for libstdc++. It takes up a ton of space, and we PCH (pre-compiled header) for libstdc++. It takes up a ton of space, and we
have no use for it.</para></listitem> have no use for it.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -164,7 +185,7 @@ GCC Specs patch.</para></note>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-gcc"/>.</para> <para>The details on this package are found in <xref linkend="contents-gcc"/>.</para>
</sect2> </sect2>

35
chapter05/gettext.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gettext"> <sect1 id="ch-tools-gettext" role="wrap">
<title>Gettext-&gettext-version;</title> <title>Gettext-&gettext-version;</title>
<?dbhtml filename="gettext.html"?> <?dbhtml filename="gettext.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Gettext">Gettext</primary> <primary sortas="a-Gettext">Gettext</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.5 SBU <segmentedlist>
&diskspace; 55 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.5 SBU</seg><seg>55 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Gettext</title> <title>Installation of Gettext</title>
<para>Prepare Gettext for compilation:</para> <para>Prepare Gettext for compilation:</para>
@ -27,17 +32,25 @@
<screen><userinput>./configure --prefix=/tools --disable-libasprintf \ <screen><userinput>./configure --prefix=/tools --disable-libasprintf \
--disable-csharp</userinput></screen> --disable-csharp</userinput></screen>
<itemizedlist> <para>The meaning of the configure options:</para>
<listitem><para><userinput>--disable-libasprintf</userinput>: This flag tells
<variablelist>
<varlistentry>
<term><userinput>--disable-libasprintf</userinput></term>
<listitem><para>This flag tells
Gettext that we don't want its asprintf library. Nothing in Chapter 5 or 6 Gettext that we don't want its asprintf library. Nothing in Chapter 5 or 6
requires this, and gettext gets rebuilt later, so we exclude it to save requires this, and gettext gets rebuilt later, so we exclude it to save
time/space.</para></listitem> time/space.</para></listitem>
</varlistentry>
<listitem><para><userinput>--disable-csharp</userinput>: Gettext has a nasty <varlistentry>
<term><userinput>--disable-csharp</userinput></term>
<listitem><para>Gettext has a nasty
habit of searching for a C# compiler on the host, and building bindings for it. habit of searching for a C# compiler on the host, and building bindings for it.
We've already <quote>locked</quote> ourselves into the temporary tools though, We've already <quote>locked</quote> ourselves into the temporary tools though,
which doesn't have a C# compiler.</para></listitem> which doesn't have a C# compiler.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compile the programs:</para> <para>Compile the programs:</para>
@ -56,7 +69,7 @@ project).)</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-gettext"/>.</para> <para>The details on this package are found in <xref linkend="contents-gettext"/>.</para>
</sect2> </sect2>

79
chapter05/glibc.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-glibc"> <sect1 id="ch-tools-glibc" role="wrap">
<title>Glibc-&glibc-version;</title> <title>Glibc-&glibc-version;</title>
<?dbhtml filename="glibc.html"?> <?dbhtml filename="glibc.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Glibc">Glibc</primary> <primary sortas="a-Glibc">Glibc</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 11.8 SBU <segmentedlist>
&diskspace; 800 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.8 SBU</seg><seg>800 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Glibc</title> <title>Installation of Glibc</title>
<para>This package is known to behave badly when you change its default <para>This package is known to behave badly when you change its default
@ -46,38 +51,56 @@ cd ../glibc-build</userinput></screen>
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--disable-profile</userinput>: This builds the <varlistentry>
<term><userinput>--disable-profile</userinput></term>
<listitem><para>This builds the
libraries without profiling information. Omit this option if you plan to do libraries without profiling information. Omit this option if you plan to do
profiling on the temporary tools.</para></listitem> profiling on the temporary tools.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-add-ons=nptl</userinput>: This <varlistentry>
tells Glibc to use the NPTL add-on as its threading library.</para></listitem> <term><userinput>--enable-add-ons=nptl</userinput></term>
<listitem><para>This tells Glibc to use the NPTL add-on as its threading
library.</para></listitem>
</varlistentry>
<listitem><para><userinput>--with-tls</userinput>: This tells Glibc to include <varlistentry>
support for TLS (thread-local storage). This is required for NPTL to work. <term><userinput>--with-tls</userinput></term>
</para></listitem> <listitem><para>This tells Glibc to include support for TLS (thread-local storage).
This is required for NPTL to work. </para></listitem>
</varlistentry>
<listitem><para><userinput>--with-binutils=/tools/bin</userinput>: Strictly <varlistentry>
speaking this switch is not required. But it does ensure nothing can go wrong <term><userinput>--with-binutils=/tools/bin</userinput></term>
with regard to what Binutils programs get used during the Glibc build.</para></listitem> <listitem><para>Strictly speaking this switch is not required. But it does ensure
nothing can go wrong with regard to what Binutils programs get used during the
Glibc build.</para></listitem>
</varlistentry>
<listitem><para><userinput>--without-gd</userinput>: This prevents the build <varlistentry>
of the <command>memusagestat</command> program, which strangely enough insists <term><userinput>--without-gd</userinput></term>
on linking against the host's libraries (libgd, libpng, libz, and so forth). <listitem><para>This prevents the build of the <command>memusagestat</command>
</para></listitem> program, which strangely enough insists on linking against the host's libraries
(libgd, libpng, libz, and so forth). </para></listitem>
</varlistentry>
<listitem><para><userinput>--without-cvs</userinput>: This is meant to prevent <varlistentry>
<term><userinput>--without-cvs</userinput></term>
<listitem><para>This is meant to prevent
the Makefiles from attempting automatic CVS checkouts when using a CVS the Makefiles from attempting automatic CVS checkouts when using a CVS
snapshot. But it's not actually needed these days. We use it because it snapshot. But it's not actually needed these days. We use it because it
suppresses an annoying but harmless warning about a missing suppresses an annoying but harmless warning about a missing
<command>autoconf</command> program.</para></listitem> <command>autoconf</command> program.</para></listitem>
</varlistentry>
<listitem><para><userinput>--with-headers=/tools/glibc-kernheaders</userinput>: <varlistentry>
This tells Glibc to compile against the <quote>raw</quote> kernel headers, so <term><userinput>--with-headers=/tools/glibc-kernheaders</userinput></term>
that it knows exactly what features the kernel has, and can optimize itself <listitem><para>This tells Glibc to compile against the <quote>raw</quote>
accordingly. Not strictly necessary, but nice to have.</para></listitem> kernel headers, so that it knows exactly what features the kernel has, and can
</itemizedlist> optimize itself accordingly. Not strictly necessary, but nice to have.</para></listitem>
</varlistentry>
</variablelist>
<para>During this stage you might see the following warning:</para> <para>During this stage you might see the following warning:</para>
@ -193,7 +216,7 @@ localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-glibc"/>.</para> <para>The details on this package are found in <xref linkend="contents-glibc"/>.</para>
</sect2> </sect2>

39
chapter05/grep.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-grep"> <sect1 id="ch-tools-grep" role="wrap">
<title>Grep-&grep-version;</title> <title>Grep-&grep-version;</title>
<?dbhtml filename="grep.html"?> <?dbhtml filename="grep.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Grep">Grep</primary> <primary sortas="a-Grep">Grep</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 5.8 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>5.8 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Grep</title> <title>Installation of Grep</title>
<para>Prepare Grep for compilation:</para> <para>Prepare Grep for compilation:</para>
@ -29,15 +34,21 @@
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--disable-perl-regexp</userinput>: This makes sure <varlistentry>
that <command>grep</command> does not get linked against a PCRE library <term><userinput>--disable-perl-regexp</userinput></term>
that may be present on the host and would not be available once we enter the <listitem><para>This makes sure that <command>grep</command> does not
chroot environment.</para></listitem> get linked against a PCRE library that may be present on the host and would not be
<listitem><para><userinput>--with-included-regex</userinput>: This ensures that available once we enter the chroot environment.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>--with-included-regex</userinput></term>
<listitem><para>This ensures that
Grep uses its internal regular expression code. Without this switch, Grep will Grep uses its internal regular expression code. Without this switch, Grep will
use the code from Glibc, which is known to be slightly buggy.</para></listitem> use the code from Glibc, which is known to be slightly buggy.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compile the programs:</para> <para>Compile the programs:</para>
@ -52,7 +63,7 @@ use the code from Glibc, which is known to be slightly buggy.</para></listitem>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-grep"/>.</para> <para>The details on this package are found in <xref linkend="contents-grep"/>.</para>
</sect2> </sect2>

19
chapter05/gzip.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gzip"> <sect1 id="ch-tools-gzip" role="wrap">
<title>Gzip-&gzip-version;</title> <title>Gzip-&gzip-version;</title>
<?dbhtml filename="gzip.html"?> <?dbhtml filename="gzip.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Gzip">Gzip</primary> <primary sortas="a-Gzip">Gzip</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 2.6 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.6 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Gzip</title> <title>Installation of Gzip</title>
<para>Prepare Gzip for compilation:</para> <para>Prepare Gzip for compilation:</para>
@ -36,7 +41,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-gzip"/>.</para> <para>The details on this package are found in <xref linkend="contents-gzip"/>.</para>
</sect2> </sect2>

14
chapter05/kernel-headers.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-kernel-headers"> <sect1 id="ch-tools-kernel-headers" role="wrap">
<title>Linux-&linux-version; headers</title> <title>Linux-&linux-version; headers</title>
<?dbhtml filename="kernel-headers.html"?> <?dbhtml filename="kernel-headers.html"?>
@ -11,11 +11,17 @@
<primary sortas="a-Linux">Linux</primary> <primary sortas="a-Linux">Linux</primary>
<secondary>tools, headers</secondary></indexterm> <secondary>tools, headers</secondary></indexterm>
<screen>&buildtime; 0.1 SBU <sect2 role="package"><title/>
&diskspace; 186 MB</screen>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>186 MB</seg></seglistitem>
</segmentedlist>
<sect2> </sect2>
<sect2 role="installation">
<title>Installation of the kernel headers</title> <title>Installation of the kernel headers</title>
<para>As some packages need to refer to the kernel header files, we're going <para>As some packages need to refer to the kernel header files, we're going

14
chapter05/linux-libc-headers.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-linux-libc-headers"> <sect1 id="ch-tools-linux-libc-headers" role="wrap">
<title>Linux-Libc-Headers-&linux-libc-headers-version;</title> <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
<?dbhtml filename="linux-libc-headers.html"?> <?dbhtml filename="linux-libc-headers.html"?>
@ -11,11 +11,17 @@
<primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary> <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
<secondary>tools, headers</secondary></indexterm> <secondary>tools, headers</secondary></indexterm>
<screen>&buildtime; 0.1 SBU <sect2 role="package"><title/>
&diskspace; 22 MB</screen>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>22 MB</seg></seglistitem>
</segmentedlist>
<sect2> </sect2>
<sect2 role="installation">
<title>Installation of Linux-Libc-Headers</title> <title>Installation of Linux-Libc-Headers</title>
<para>For years it has been common practice to use so-called <quote>raw</quote> <para>For years it has been common practice to use so-called <quote>raw</quote>

19
chapter05/m4.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-m4" xreflabel="M4"> <sect1 id="ch-tools-m4" xreflabel="M4" role="wrap">
<title>M4-&m4-version;</title> <title>M4-&m4-version;</title>
<?dbhtml filename="m4.html"?> <?dbhtml filename="m4.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-M4">M4</primary> <primary sortas="a-M4">M4</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 3.0 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>3.0 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of M4</title> <title>Installation of M4</title>
<para>Prepare M4 for compilation:</para> <para>Prepare M4 for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-m4"/>.</para> <para>The details on this package are found in <xref linkend="contents-m4"/>.</para>
</sect2> </sect2>

19
chapter05/make.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-make"> <sect1 id="ch-tools-make" role="wrap">
<title>Make-&make-version;</title> <title>Make-&make-version;</title>
<?dbhtml filename="make.html"?> <?dbhtml filename="make.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Make">Make</primary> <primary sortas="a-Make">Make</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 8.8 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Make</title> <title>Installation of Make</title>
<para>Prepare Make for compilation:</para> <para>Prepare Make for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-make"/>.</para> <para>The details on this package are found in <xref linkend="contents-make"/>.</para>
</sect2> </sect2>

39
chapter05/ncurses.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-ncurses"> <sect1 id="ch-tools-ncurses" role="wrap">
<title>Ncurses-&ncurses-version;</title> <title>Ncurses-&ncurses-version;</title>
<?dbhtml filename="ncurses.html"?> <?dbhtml filename="ncurses.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Ncurses">Ncurses</primary> <primary sortas="a-Ncurses">Ncurses</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.7 SBU <segmentedlist>
&diskspace; 26 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.7 SBU</seg><seg>26 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Ncurses</title> <title>Installation of Ncurses</title>
<para>Prepare Ncurses for compilation:</para> <para>Prepare Ncurses for compilation:</para>
@ -29,17 +34,23 @@
<para>The meaning of the configure options:</para> <para>The meaning of the configure options:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>--without-ada</userinput>: This tells Ncurses not <varlistentry>
<term><userinput>--without-ada</userinput></term>
<listitem><para>This tells Ncurses not
to build its Ada bindings, even if an Ada compiler is installed on the host. to build its Ada bindings, even if an Ada compiler is installed on the host.
This must be done because once we enter the chroot environment, Ada will no This must be done because once we enter the chroot environment, Ada will no
longer be available.</para></listitem> longer be available.</para></listitem>
</varlistentry>
<listitem><para><userinput>--enable-overwrite</userinput>: This tells Ncurses <varlistentry>
to install its header files into <filename class="directory">/tools/include</filename> <term><userinput>--enable-overwrite</userinput></term>
instead of <filename class="directory">/tools/include/ncurses</filename> to <listitem><para>This tells Ncurses to install its header files into
ensure that other packages can find the Ncurses headers successfully.</para> <filename class="directory">/tools/include</filename> instead of
</listitem></itemizedlist> <filename class="directory">/tools/include/ncurses</filename> to ensure that
other packages can find the Ncurses headers successfully.</para></listitem>
</varlistentry>
</variablelist>
<para>Compile the programs and libraries:</para> <para>Compile the programs and libraries:</para>
@ -51,7 +62,7 @@ ensure that other packages can find the Ncurses headers successfully.</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-ncurses"/>.</para> <para>The details on this package are found in <xref linkend="contents-ncurses"/>.</para>
</sect2> </sect2>

19
chapter05/patch.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-patch"> <sect1 id="ch-tools-patch" role="wrap">
<title>Patch-&patch-version;</title> <title>Patch-&patch-version;</title>
<?dbhtml filename="patch.html"?> <?dbhtml filename="patch.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Patch">Patch</primary> <primary sortas="a-Patch">Patch</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.1 SBU <segmentedlist>
&diskspace; 1.9 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>1.9 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Patch</title> <title>Installation of Patch</title>
<para>Prepare Patch for compilation (the preprocessor flag <para>Prepare Patch for compilation (the preprocessor flag
@ -38,7 +43,7 @@ other architectures you can leave it out):</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-patch"/>.</para> <para>The details on this package are found in <xref linkend="contents-patch"/>.</para>
</sect2> </sect2>

28
chapter05/perl.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-perl"> <sect1 id="ch-tools-perl" role="wrap">
<title>Perl-&perl-version;</title> <title>Perl-&perl-version;</title>
<?dbhtml filename="perl.html"?> <?dbhtml filename="perl.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Perl">Perl</primary> <primary sortas="a-Perl">Perl</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.8 SBU <segmentedlist>
&diskspace; 74 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.8 SBU</seg><seg>74 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Perl</title> <title>Installation of Perl</title>
<para>First adapt some hard-wired paths to the C library:</para> <para>First adapt some hard-wired paths to the C library:</para>
@ -33,11 +38,14 @@ right, they are all letters):</para>
<para>The meaning of the configure option:</para> <para>The meaning of the configure option:</para>
<itemizedlist> <variablelist>
<listitem><para><userinput>-Dstatic_ext='IO Fcntl POSIX'</userinput>: This tells <varlistentry>
<term><userinput>-Dstatic_ext='IO Fcntl POSIX'</userinput></term>
<listitem><para>This tells
Perl to build the minimum set of static extensions needed for installing and Perl to build the minimum set of static extensions needed for installing and
testing the Coreutils package in the next chapter.</para></listitem> testing the Coreutils package in the next chapter.</para></listitem>
</itemizedlist> </varlistentry>
</variablelist>
<para>Compile only the required tools:</para> <para>Compile only the required tools:</para>
@ -51,7 +59,7 @@ cp -R lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-perl"/>.</para> <para>The details on this package are found in <xref linkend="contents-perl"/>.</para>
</sect2> </sect2>

19
chapter05/sed.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-sed"> <sect1 id="ch-tools-sed" role="wrap">
<title>Sed-&sed-version;</title> <title>Sed-&sed-version;</title>
<?dbhtml filename="sed.html"?> <?dbhtml filename="sed.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Sed">Sed</primary> <primary sortas="a-Sed">Sed</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 5.2 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>5.2 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Sed</title> <title>Installation of Sed</title>
<para>Prepare Sed for compilation:</para> <para>Prepare Sed for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-sed"/>.</para> <para>The details on this package are found in <xref linkend="contents-sed"/>.</para>
</sect2> </sect2>

19
chapter05/tar.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-tar"> <sect1 id="ch-tools-tar" role="wrap">
<title>Tar-&tar-version;</title> <title>Tar-&tar-version;</title>
<?dbhtml filename="tar.html"?> <?dbhtml filename="tar.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Tar">Tar</primary> <primary sortas="a-Tar">Tar</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 10 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>10 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Tar</title> <title>Installation of Tar</title>
<para>Prepare Tar for compilation:</para> <para>Prepare Tar for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-tar"/>.</para> <para>The details on this package are found in <xref linkend="contents-tar"/>.</para>
</sect2> </sect2>

56
chapter05/tcl.xml
View File

@ -3,23 +3,30 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-tcl" xreflabel="Tcl"> <sect1 id="ch-tools-tcl" xreflabel="Tcl" role="wrap">
<title>Tcl-&tcl-version;</title> <title>Tcl-&tcl-version;</title>
<?dbhtml filename="tcl.html"?> <?dbhtml filename="tcl.html"?>
<indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm> <indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>
<sect2 role="package"><title/>
<para>The Tcl package contains the Tool Command Language.</para> <para>The Tcl package contains the Tool Command Language.</para>
<screen>&buildtime; 0.9 SBU <segmentedlist>
&diskspace; 23 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.9 SBU</seg><seg>23 MB</seg></seglistitem>
</segmentedlist>
<para>Tcl installation depends on: Bash, Binutils, Coreutils, Diffutils, <segmentedlist>
GCC, Glibc, Grep, Make, Sed.</para> <segtitle>Tcl installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<sect2>
<title>Installation of Tcl</title> <title>Installation of Tcl</title>
<para>This package and the next two are only installed to support running the <para>This package and the next two are only installed to support running the
@ -53,38 +60,43 @@ will be given later on in <xref linkend="chapter-bootscripts"/>.</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<warning><para><emphasis>Do not remove</emphasis> the <warning><para><emphasis>Do not remove</emphasis> the
<filename>tcl&tcl-version;</filename> source directory yet, as the next package <filename>tcl&tcl-version;</filename> source directory yet, as the next package
will need its internal headers.</para></warning> will need its internal headers.</para></warning>
<para>Now make a necessary symbolic link:</para> <para>Now make a necessary symbolic link:</para>
<screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen> <screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-tcl" role="content"><title>Contents of Tcl</title>
<sect2 id="contents-tcl"><title>Contents of Tcl</title> <segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>tclsh (link to tclsh8.4), tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
</segmentedlist>
<para><emphasis>Installed programs</emphasis>: tclsh (link to tclsh8.4), <variablelist><title>Short descriptions</title>
tclsh8.4</para>
<para><emphasis>Installed library</emphasis>: libtcl8.4.so</para>
</sect2>
<sect2><title>Short descriptions</title>
<varlistentry>
<term id="tclsh8.4"><command>tclsh8.4</command></term>
<listitem>
<indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm> <indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
<para id="tclsh8.4"><command>tclsh8.4</command> is the Tcl command shell.</para> <para>is the Tcl command shell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term id="libtcl8.4.so"><command>libtcl8.4.so</command></term>
<listitem>
<indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm> <indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
<para id="libtcl8.4.so"><command>libtcl8.4.so</command> is the Tcl library.</para> <para>is the Tcl library.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2> </sect2>
</sect1> </sect1>

19
chapter05/texinfo.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-texinfo"> <sect1 id="ch-tools-texinfo" role="wrap">
<title>Texinfo-&texinfo-version;</title> <title>Texinfo-&texinfo-version;</title>
<?dbhtml filename="texinfo.html"?> <?dbhtml filename="texinfo.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Texinfo">Texinfo</primary> <primary sortas="a-Texinfo">Texinfo</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 16 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>16 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Texinfo</title> <title>Installation of Texinfo</title>
<para>Prepare Texinfo for compilation:</para> <para>Prepare Texinfo for compilation:</para>
@ -39,7 +44,7 @@
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-texinfo"/>.</para> <para>The details on this package are found in <xref linkend="contents-texinfo"/>.</para>
</sect2> </sect2>

20
chapter05/udev.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-udev"> <sect1 id="ch-tools-udev" role="wrap">
<title>Udev-&udev-version;</title> <title>Udev-&udev-version;</title>
<?dbhtml filename="udev.html"?> <?dbhtml filename="udev.html"?>
@ -11,18 +11,24 @@
<primary sortas="a-Udev">Udev</primary> <primary sortas="a-Udev">Udev</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<sect2 role="package"><title/>
<!-- <!--
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/para[1])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
--> -->
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 5.2 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>5.2 MB</seg></seglistitem>
</segmentedlist>
<!-- <!--
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
--> -->
<sect2> </sect2>
<sect2 role="installation">
<title>Installation of Udev</title> <title>Installation of Udev</title>
<para>By default, the permissions udev assigns to nodes are all uniform, <para>By default, the permissions udev assigns to nodes are all uniform,
@ -58,7 +64,7 @@ configuration files:</para>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-udev"/>.</para> <para>The details on this package are found in <xref linkend="contents-udev"/>.</para>
</sect2> </sect2>

19
chapter05/util-linux.xml
View File

@ -3,7 +3,7 @@
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-util-linux"> <sect1 id="ch-tools-util-linux" role="wrap">
<title>Util-linux-&util-linux-version;</title> <title>Util-linux-&util-linux-version;</title>
<?dbhtml filename="util-linux.html"?> <?dbhtml filename="util-linux.html"?>
@ -11,15 +11,20 @@
<primary sortas="a-Util-linux">Util-linux</primary> <primary sortas="a-Util-linux">Util-linux</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary></indexterm>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/para[1])"/> <sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<screen>&buildtime; 0.2 SBU <segmentedlist>
&diskspace; 16 MB</screen> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>16 MB</seg></seglistitem>
</segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/para[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2>
<sect2> <sect2 role="installation">
<title>Installation of Util-linux</title> <title>Installation of Util-linux</title>
<para>Util-linux has issues with the Linux 2.6 kernel series - fix these issues <para>Util-linux has issues with the Linux 2.6 kernel series - fix these issues
@ -53,7 +58,7 @@ make -C text-utils more</userinput></screen>
</sect2> </sect2>
<sect2><title/> <sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-utillinux"/>.</para> <para>The details on this package are found in <xref linkend="contents-utillinux"/>.</para>
</sect2> </sect2>
</sect1> </sect1>