r5300 - in branches/cross-lfs/BOOK/temp-tools: . common

jhuntwork at linuxfromscratch.org jhuntwork at linuxfromscratch.org
Wed May 11 21:21:56 PDT 2005


Author: jhuntwork
Date: 2005-05-11 22:21:52 -0600 (Wed, 11 May 2005)
New Revision: 5300

Added:
   branches/cross-lfs/BOOK/temp-tools/common/
   branches/cross-lfs/BOOK/temp-tools/common/binutils.xml
   branches/cross-lfs/BOOK/temp-tools/common/dejagnu.xml
   branches/cross-lfs/BOOK/temp-tools/common/expect.xml
   branches/cross-lfs/BOOK/temp-tools/common/introduction.xml
   branches/cross-lfs/BOOK/temp-tools/common/perl.xml
   branches/cross-lfs/BOOK/temp-tools/common/tcl.xml
   branches/cross-lfs/BOOK/temp-tools/ppc-chapter.xml
   branches/cross-lfs/BOOK/temp-tools/raq2-chapter.xml
   branches/cross-lfs/BOOK/temp-tools/sparc-chapter.xml
   branches/cross-lfs/BOOK/temp-tools/sparc64-chapter.xml
   branches/cross-lfs/BOOK/temp-tools/x86-chapter.xml
Removed:
   branches/cross-lfs/BOOK/temp-tools/binutils.xml
   branches/cross-lfs/BOOK/temp-tools/chapter.xml
   branches/cross-lfs/BOOK/temp-tools/dejagnu.xml
   branches/cross-lfs/BOOK/temp-tools/expect.xml
   branches/cross-lfs/BOOK/temp-tools/introduction.xml
   branches/cross-lfs/BOOK/temp-tools/perl.xml
   branches/cross-lfs/BOOK/temp-tools/tcl.xml
Log:
Updating temp-tools dir

Deleted: branches/cross-lfs/BOOK/temp-tools/binutils.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/binutils.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/binutils.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,105 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-binutils" role="wrap">
-<title>Binutils-&binutils-version;</title>
-<?dbhtml filename="binutils.html"?>
-
-<indexterm zone="ch-temp-tools-binutils">
-<primary sortas="a-Binutils">Binutils</primary>
-<secondary>temporary tools</secondary></indexterm>
-
-<sect2 role="package"><title/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../final-system/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
-
-<segmentedlist>
-<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="../final-system/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
-
-</sect2>
-
-<sect2 role="installation">
-<title>Installation of Binutils</title>
-
-<para>It is important that Binutils be the first package compiled
-because both Glibc and GCC perform various tests on the available
-linker and assembler to determine which of their own features to
-enable.</para>
-
-<para>This package is known to have issues when its default
-optimization flags (including the <parameter>-march</parameter> and
-<parameter>-mcpu</parameter> options) are changed. If any environment
-variables that override default optimizations have been defined, such
-as <envar>CFLAGS</envar> and <envar>CXXFLAGS</envar>,
-unset them when building Binutils.</para>
-
-<para>The Binutils documentation recommends building Binutils outside of the
-source directory in a dedicated build directory:</para>
-
-<screen><userinput>mkdir ../binutils-build
-cd ../binutils-build</userinput></screen>
-
-<note><para>In order for the SBU values listed in the rest of the book
-to be of any use, measure the time it takes to build this package from
-the configuration, up to and including the first install. To achieve
-this easily, wrap the four commands in a <command>time</command>
-command like this: <userinput>time { ./configure ... && ...
-&& ... && make install; }</userinput>.</para></note>
-
-
-<para>Now prepare Binutils for compilation:</para>
-
-<screen><userinput>../binutils-&binutils-version;/configure \
-     --prefix=/tools --host=${LFS_TARGET} \
-     --disable-nls --enable-shared --enable-64-bit-bfd</userinput></screen>
-
-<para>The meaning of the configure options:</para>
-
-<variablelist>
-<varlistentry>
-<term><parameter>--prefix=/tools</parameter></term>
-<listitem><para>This tells the configure script to prepare to install the Binutils
-programs in the <filename class="directory">/tools</filename> directory.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><parameter>--disable-nls</parameter></term>
-<listitem><para>This disables internationalization. This is not needed for the
-temporary tools.</para></listitem>
-</varlistentry>
-</variablelist>
-
-<para>Continue with compiling the package:</para>
-
-<screen><userinput>make headers -C bfd
-make</userinput></screen>
-
-<para>Compilation is now complete. Ordinarily we would now run the
-test suite, but at this early stage the test suite framework (Tcl,
-Expect, and DejaGNU) is not yet in place. The benefits of running the
-tests at this point are minimal since the programs from this
-first pass will soon be replaced by those from the second.</para>
-
-<para>Install the package:</para>
-
-<screen><userinput>make install</userinput></screen>
-
-<para>Copy libiberty.h file to /tools/include directory:</para>
-
-<screen>cp ../binutils-&binutils-version;/include/libiberty.h /tools/include</screen>
-
-</sect2>
-
-<sect2 role="content"><title/>
-<para>Details on this package are located in <xref
-linkend="contents-binutils" role="."/></para>
-</sect2>
-
-</sect1>
-

Deleted: branches/cross-lfs/BOOK/temp-tools/chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
-<?dbhtml dir="temp-tools"?>
-<title>Constructing a Temporary Tools</title>
-<?dbhtml filename="chapter.html"?>
-
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tcl.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="expect.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dejagnu.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="perl.xml"/>
-
-</chapter>

Added: branches/cross-lfs/BOOK/temp-tools/common/binutils.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/binutils.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/binutils.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-binutils" role="wrap">
+<title>Binutils-&binutils-version;</title>
+<?dbhtml filename="binutils.html"?>
+
+<indexterm zone="ch-temp-tools-binutils">
+<primary sortas="a-Binutils">Binutils</primary>
+<secondary>temporary tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../final-system/common/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<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="../../final-system/common/binutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Binutils</title>
+
+<para>It is important that Binutils be the first package compiled
+because both Glibc and GCC perform various tests on the available
+linker and assembler to determine which of their own features to
+enable.</para>
+
+<para>This package is known to have issues when its default
+optimization flags (including the <parameter>-march</parameter> and
+<parameter>-mcpu</parameter> options) are changed. If any environment
+variables that override default optimizations have been defined, such
+as <envar>CFLAGS</envar> and <envar>CXXFLAGS</envar>,
+unset them when building Binutils.</para>
+
+<para>The Binutils documentation recommends building Binutils outside of the
+source directory in a dedicated build directory:</para>
+
+<screen><userinput>mkdir ../binutils-build
+cd ../binutils-build</userinput></screen>
+
+<note><para>In order for the SBU values listed in the rest of the book
+to be of any use, measure the time it takes to build this package from
+the configuration, up to and including the first install. To achieve
+this easily, wrap the four commands in a <command>time</command>
+command like this: <userinput>time { ./configure ... && ...
+&& ... && make install; }</userinput>.</para></note>
+
+
+<para>Now prepare Binutils for compilation:</para>
+
+<screen><userinput>../binutils-&binutils-version;/configure \
+     --prefix=/tools --host=${LFS_TARGET} \
+     --disable-nls --enable-shared --enable-64-bit-bfd</userinput></screen>
+
+<para>The meaning of the configure options:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--prefix=/tools</parameter></term>
+<listitem><para>This tells the configure script to prepare to install the Binutils
+programs in the <filename class="directory">/tools</filename> directory.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><parameter>--disable-nls</parameter></term>
+<listitem><para>This disables internationalization. This is not needed for the
+temporary tools.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>Continue with compiling the package:</para>
+
+<screen><userinput>make headers -C bfd
+make</userinput></screen>
+
+<para>Compilation is now complete. Ordinarily we would now run the
+test suite, but at this early stage the test suite framework (Tcl,
+Expect, and DejaGNU) is not yet in place. The benefits of running the
+tests at this point are minimal since the programs from this
+first pass will soon be replaced by those from the second.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+<para>Copy libiberty.h file to /tools/include directory:</para>
+
+<screen>cp ../binutils-&binutils-version;/include/libiberty.h /tools/include</screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-binutils" role="."/></para>
+</sect2>
+
+</sect1>
+

Added: branches/cross-lfs/BOOK/temp-tools/common/dejagnu.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/dejagnu.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/dejagnu.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-dejagnu" role="wrap">
+<title>DejaGNU-&dejagnu-version;</title>
+<?dbhtml filename="dejagnu.html"?>
+
+<indexterm zone="ch-temp-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>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>0.1 SBU</seg><seg>8.6 MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>&dependencies;</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of DejaGNU</title>
+
+<para>Prepare DejaGNU for compilation:</para>
+
+<screen><userinput>./configure --prefix=/tools</userinput></screen>
+
+<para>Build and install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-dejagnu" role="content"><title>Contents of DejaGNU</title>
+
+<segmentedlist>
+<segtitle>Installed program</segtitle>
+<seglistitem><seg>runtest</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+<?dbhtml list-presentation="table"?>
+
+<varlistentry id="runtest">
+<term><command>runtest</command></term>
+<listitem>
+<para>A wrapper script that locates the proper
+<command>expect</command> shell and then runs DejaGNU</para>
+<indexterm zone="ch-temp-tools-dejagnu runtest"><primary sortas="b-runtest">runtest</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+

Added: branches/cross-lfs/BOOK/temp-tools/common/expect.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/expect.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/expect.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-expect" role="wrap">
+<title>Expect-&expect-version;</title>
+<?dbhtml filename="expect.html"?>
+
+<indexterm zone="ch-temp-tools-expect"><primary sortas="a-Expect">Expect</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Expect package contains a program for carrying out scripted dialogues
+with other interactive programs.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>0.1 SBU</seg><seg>3.9 MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>&dependencies;</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Glibc, Grep, Make, Sed, and Tcl</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Expect</title>
+
+<para>First, fix a bug that can result in false failures during the GCC test
+suite run:</para>
+
+<screen><userinput>patch -Np1 -i ../expect-&expect-version;-spawn-1.patch</userinput></screen>
+
+<para>Now prepare Expect for compilation:</para>
+
+<screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib --with-x=no</userinput></screen>
+
+<para>The meaning of the configure options:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--with-tcl=/tools/lib</parameter></term>
+<listitem><para>This ensures that the configure script finds the Tcl installation in
+the temporary temp-tools location instead of possibly locating an existing
+one on the host system.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><parameter>--with-x=no</parameter></term>
+<listitem><para>This tells the configure script not to search for Tk
+(the Tcl GUI component) or the X Window System libraries, both of
+which may reside on the host system.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>Build the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>To test the results, issue: <userinput>make test</userinput>.
+Note that the Expect test suite is known to experience failures under
+certain host conditions that are not within our control. Therefore,
+test suite failures here are not surprising and are not considered
+critical.</para>
+
+
+<para>Install the package:</para>
+
+<screen><userinput>make SCRIPTS="" install</userinput></screen>
+
+<para>The meaning of the make parameter:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>SCRIPTS=""</parameter></term>
+<listitem><para>This prevents installation of the supplementary expect
+scripts, which are not needed.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>The source directories of both Tcl and Expect can now be removed.</para>
+
+</sect2>
+
+<sect2 id="contents-expect" role="content"><title>Contents of Expect</title>
+
+<segmentedlist>
+<segtitle>Installed program</segtitle>
+<segtitle>Installed library</segtitle>
+<seglistitem><seg>expect</seg><seg>libexpect-5.42.a</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+<?dbhtml list-presentation="table"?>
+
+<varlistentry id="expect">
+<term><command>expect</command></term>
+<listitem>
+<para>Communicates with other interactive
+programs according to a script</para>
+<indexterm zone="ch-temp-tools-expect expect"><primary sortas="b-expect">expect</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libexpect">
+<term><filename class="libraryfile">libexpect-5.42.a</filename></term>
+<listitem>
+<para>Contains functions that allow Expect to be used as a Tcl extension or to
+be used directly from C or C++ (without Tcl)</para>
+<indexterm zone="ch-temp-tools-expect libexpect"><primary
+sortas="c-libexpect-5.42">libexpect-5.42</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+

Added: branches/cross-lfs/BOOK/temp-tools/common/introduction.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/introduction.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/introduction.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-introduction">
+<title>Introduction</title>
+<?dbhtml filename="introduction.html"?>
+
+<para>This chapter builds the tools needed to run the tests
+that the packages have. ie make check</para>
+
+<para>It will also build any specific non cross-compiled
+packages for our system.</para>
+
+</sect1>
+

Added: branches/cross-lfs/BOOK/temp-tools/common/perl.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/perl.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/perl.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-perl" role="wrap">
+<title>Perl-&perl-version;</title>
+<?dbhtml filename="perl.html"?>
+
+<indexterm zone="ch-temp-tools-perl">
+<primary sortas="a-Perl">Perl</primary>
+<secondary>temporary system</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../final-system/common/perl.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<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="../../final-system/common/perl.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Perl</title>
+
+<para>First adapt some hard-wired paths to the C library by applying
+the following patch:</para>
+
+<screen><userinput>patch -Np1 -i ../perl-&perl-version;-libc-1.patch</userinput></screen>
+
+<para>Prepare Perl for compilation (make sure to get the 'IO Fcntl POSIX'
+part of the command correct—they are all letters):</para>
+
+<screen><userinput>./configure.gnu --prefix=/tools -Dstatic_ext='IO Fcntl POSIX'</userinput></screen>
+
+<para>The meaning of the configure option:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>-Dstatic_ext='IO Fcntl POSIX'</parameter></term>
+<listitem><para>This tells Perl to build the minimum set of static
+extensions needed for installing and testing the Coreutils package in
+the next chapter.</para></listitem>
+</varlistentry>
+</variablelist>
+
+
+<para>Compile only the required tools:</para>
+
+<screen><userinput>make perl utilities</userinput></screen>
+
+<para>Although Perl comes with a test suite, it is not recommended to
+run it at this point. Only part of Perl was built and running
+<userinput>make test</userinput> now will cause the rest of Perl to be
+built as well, which is unnecessary at this point. The test suite can
+be run in the next chapter if desired.</para>
+
+<para>Copy these tools and their libraries:</para>
+
+<screen><userinput>cp perl pod/pod2man /tools/bin
+install -d /tools/lib/perl5/&perl-version;
+cp -R lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-perl" role="."/></para>
+</sect2>
+
+</sect1>
+

Added: branches/cross-lfs/BOOK/temp-tools/common/tcl.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/common/tcl.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/common/tcl.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-temp-tools-tcl" role="wrap">
+<title>Tcl-&tcl-version;</title>
+<?dbhtml filename="tcl.html"?>
+
+<indexterm zone="ch-temp-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Tcl package contains the Tool Command Language.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>0.9 SBU</seg><seg>23 MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>&dependencies;</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
+</segmentedlist>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Tcl</title>
+
+<para>This package and the next two (Expect and DejaGNU) are
+installed to support running the test suites for GCC and Binutils.
+Installing three packages for testing purposes may seem excessive, but
+it is very reassuring, if not essential, to know that the most
+important tools are working properly. Even if the test suites are not
+run in this chapter (they are not mandatory), these packages
+are required to run the test suites in <xref
+linkend="chapter-building-system"/>.</para>
+
+<para>Prepare Tcl for compilation:</para>
+
+<screen><userinput>cd unix
+./configure --prefix=/tools</userinput></screen>
+
+<para>Build the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>To test the results, issue: <userinput>TZ=UTC make
+test</userinput>. The Tcl test suite is known to experience failures
+under certain host conditions that are not fully understood.
+Therefore, test suite failures here are not surprising, and are not
+considered critical. The <parameter>TZ=UTC</parameter> parameter sets
+the time zone to Coordinated Universal Time (UTC), also known as
+Greenwich Mean Time (GMT), but only for the duration of the test suite
+run. This ensures that the clock tests are exercised correctly.
+Details on the <envar>TZ</envar> environment variable is provided in
+<xref linkend="chapter-bootscripts"/>.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+
+<warning><para><emphasis>Do not</emphasis> remove the
+<filename class="directory">tcl&tcl-version;</filename> source directory yet, as the next package
+will need its internal headers.</para></warning>
+
+<para>Now make a necessary symbolic link:</para>
+
+<screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
+
+</sect2>
+
+<sect2 id="contents-tcl" role="content"><title>Contents of Tcl</title>
+
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<segtitle>Installed library</segtitle>
+<seglistitem><seg>tclsh (link to tclsh8.4) and tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+<?dbhtml list-presentation="table"?>
+
+<varlistentry id="tclsh8.4">
+<term><command>tclsh8.4</command></term>
+<listitem>
+<para>The Tcl command shell</para>
+<indexterm zone="ch-temp-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tclsh">
+<term><command>tclsh</command></term>
+<listitem>
+<para>A link to tclsh8.4</para>
+<indexterm zone="ch-temp-tools-tcl tclsh"><primary sortas="b-tclsh">tclsh</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libtcl8.4.so">
+<term><filename class="libraryfile">libtcl8.4.so</filename></term>
+<listitem>
+<para>The Tcl library</para>
+<indexterm zone="ch-temp-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+

Deleted: branches/cross-lfs/BOOK/temp-tools/dejagnu.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/dejagnu.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/dejagnu.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,66 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-dejagnu" role="wrap">
-<title>DejaGNU-&dejagnu-version;</title>
-<?dbhtml filename="dejagnu.html"?>
-
-<indexterm zone="ch-temp-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>
-
-<segmentedlist>
-<segtitle>&buildtime;</segtitle>
-<segtitle>&diskspace;</segtitle>
-<seglistitem><seg>0.1 SBU</seg><seg>8.6 MB</seg></seglistitem>
-</segmentedlist>
-
-<segmentedlist>
-<segtitle>&dependencies;</segtitle>
-<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
-GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
-</segmentedlist>
-</sect2>
-
-<sect2 role="installation">
-<title>Installation of DejaGNU</title>
-
-<para>Prepare DejaGNU for compilation:</para>
-
-<screen><userinput>./configure --prefix=/tools</userinput></screen>
-
-<para>Build and install the package:</para>
-
-<screen><userinput>make install</userinput></screen>
-
-</sect2>
-
-
-<sect2 id="contents-dejagnu" role="content"><title>Contents of DejaGNU</title>
-
-<segmentedlist>
-<segtitle>Installed program</segtitle>
-<seglistitem><seg>runtest</seg></seglistitem>
-</segmentedlist>
-
-<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
-<?dbhtml list-presentation="table"?>
-
-<varlistentry id="runtest">
-<term><command>runtest</command></term>
-<listitem>
-<para>A wrapper script that locates the proper
-<command>expect</command> shell and then runs DejaGNU</para>
-<indexterm zone="ch-temp-tools-dejagnu runtest"><primary sortas="b-runtest">runtest</primary></indexterm>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-</sect1>
-

Deleted: branches/cross-lfs/BOOK/temp-tools/expect.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/expect.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/expect.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,123 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-expect" role="wrap">
-<title>Expect-&expect-version;</title>
-<?dbhtml filename="expect.html"?>
-
-<indexterm zone="ch-temp-tools-expect"><primary sortas="a-Expect">Expect</primary></indexterm>
-
-<sect2 role="package"><title/>
-<para>The Expect package contains a program for carrying out scripted dialogues
-with other interactive programs.</para>
-
-<segmentedlist>
-<segtitle>&buildtime;</segtitle>
-<segtitle>&diskspace;</segtitle>
-<seglistitem><seg>0.1 SBU</seg><seg>3.9 MB</seg></seglistitem>
-</segmentedlist>
-
-<segmentedlist>
-<segtitle>&dependencies;</segtitle>
-<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
-GCC, Glibc, Grep, Make, Sed, and Tcl</seg></seglistitem>
-</segmentedlist>
-</sect2>
-
-<sect2 role="installation">
-<title>Installation of Expect</title>
-
-<para>First, fix a bug that can result in false failures during the GCC test
-suite run:</para>
-
-<screen><userinput>patch -Np1 -i ../expect-&expect-version;-spawn-1.patch</userinput></screen>
-
-<para>Now prepare Expect for compilation:</para>
-
-<screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib --with-x=no</userinput></screen>
-
-<para>The meaning of the configure options:</para>
-
-<variablelist>
-<varlistentry>
-<term><parameter>--with-tcl=/tools/lib</parameter></term>
-<listitem><para>This ensures that the configure script finds the Tcl installation in
-the temporary temp-tools location instead of possibly locating an existing
-one on the host system.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><parameter>--with-x=no</parameter></term>
-<listitem><para>This tells the configure script not to search for Tk
-(the Tcl GUI component) or the X Window System libraries, both of
-which may reside on the host system.</para></listitem>
-</varlistentry>
-</variablelist>
-
-<para>Build the package:</para>
-
-<screen><userinput>make</userinput></screen>
-
-<para>To test the results, issue: <userinput>make test</userinput>.
-Note that the Expect test suite is known to experience failures under
-certain host conditions that are not within our control. Therefore,
-test suite failures here are not surprising and are not considered
-critical.</para>
-
-
-<para>Install the package:</para>
-
-<screen><userinput>make SCRIPTS="" install</userinput></screen>
-
-<para>The meaning of the make parameter:</para>
-
-<variablelist>
-<varlistentry>
-<term><parameter>SCRIPTS=""</parameter></term>
-<listitem><para>This prevents installation of the supplementary expect
-scripts, which are not needed.</para></listitem>
-</varlistentry>
-</variablelist>
-
-<para>The source directories of both Tcl and Expect can now be removed.</para>
-
-</sect2>
-
-<sect2 id="contents-expect" role="content"><title>Contents of Expect</title>
-
-<segmentedlist>
-<segtitle>Installed program</segtitle>
-<segtitle>Installed library</segtitle>
-<seglistitem><seg>expect</seg><seg>libexpect-5.42.a</seg></seglistitem>
-</segmentedlist>
-
-<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
-<?dbhtml list-presentation="table"?>
-
-<varlistentry id="expect">
-<term><command>expect</command></term>
-<listitem>
-<para>Communicates with other interactive
-programs according to a script</para>
-<indexterm zone="ch-temp-tools-expect expect"><primary sortas="b-expect">expect</primary></indexterm>
-</listitem>
-</varlistentry>
-
-<varlistentry id="libexpect">
-<term><filename class="libraryfile">libexpect-5.42.a</filename></term>
-<listitem>
-<para>Contains functions that allow Expect to be used as a Tcl extension or to
-be used directly from C or C++ (without Tcl)</para>
-<indexterm zone="ch-temp-tools-expect libexpect"><primary
-sortas="c-libexpect-5.42">libexpect-5.42</primary></indexterm>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-</sect1>
-

Deleted: branches/cross-lfs/BOOK/temp-tools/introduction.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/introduction.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/introduction.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-introduction">
-<title>Introduction</title>
-<?dbhtml filename="introduction.html"?>
-
-<para>This chapter builds the tools needed to run the tests
-that the packages have. ie make check</para>
-
-<para>It will also build any specific non cross-compiled
-packages for our system.</para>
-
-</sect1>
-

Deleted: branches/cross-lfs/BOOK/temp-tools/perl.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/perl.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/perl.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,76 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-perl" role="wrap">
-<title>Perl-&perl-version;</title>
-<?dbhtml filename="perl.html"?>
-
-<indexterm zone="ch-temp-tools-perl">
-<primary sortas="a-Perl">Perl</primary>
-<secondary>temporary system</secondary></indexterm>
-
-<sect2 role="package"><title/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../final-system/perl.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
-
-<segmentedlist>
-<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="../final-system/perl.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
-
-</sect2>
-
-<sect2 role="installation">
-<title>Installation of Perl</title>
-
-<para>First adapt some hard-wired paths to the C library by applying
-the following patch:</para>
-
-<screen><userinput>patch -Np1 -i ../perl-&perl-version;-libc-1.patch</userinput></screen>
-
-<para>Prepare Perl for compilation (make sure to get the 'IO Fcntl POSIX'
-part of the command correct—they are all letters):</para>
-
-<screen><userinput>./configure.gnu --prefix=/tools -Dstatic_ext='IO Fcntl POSIX'</userinput></screen>
-
-<para>The meaning of the configure option:</para>
-
-<variablelist>
-<varlistentry>
-<term><parameter>-Dstatic_ext='IO Fcntl POSIX'</parameter></term>
-<listitem><para>This tells Perl to build the minimum set of static
-extensions needed for installing and testing the Coreutils package in
-the next chapter.</para></listitem>
-</varlistentry>
-</variablelist>
-
-
-<para>Compile only the required tools:</para>
-
-<screen><userinput>make perl utilities</userinput></screen>
-
-<para>Although Perl comes with a test suite, it is not recommended to
-run it at this point. Only part of Perl was built and running
-<userinput>make test</userinput> now will cause the rest of Perl to be
-built as well, which is unnecessary at this point. The test suite can
-be run in the next chapter if desired.</para>
-
-<para>Copy these tools and their libraries:</para>
-
-<screen><userinput>cp perl pod/pod2man /tools/bin
-install -d /tools/lib/perl5/&perl-version;
-cp -R lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
-
-</sect2>
-
-<sect2 role="content"><title/>
-<para>Details on this package are located in <xref
-linkend="contents-perl" role="."/></para>
-</sect2>
-
-</sect1>
-

Added: branches/cross-lfs/BOOK/temp-tools/ppc-chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/ppc-chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/ppc-chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
+<?dbhtml dir="temp-tools"?>
+<title>Constructing a Temporary Tools</title>
+<?dbhtml filename="chapter.html"?>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/expect.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/dejagnu.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/perl.xml"/>
+
+</chapter>

Added: branches/cross-lfs/BOOK/temp-tools/raq2-chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/raq2-chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/raq2-chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
+<?dbhtml dir="temp-tools"?>
+<title>Constructing a Temporary Tools</title>
+<?dbhtml filename="chapter.html"?>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/expect.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/dejagnu.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/perl.xml"/>
+
+</chapter>

Added: branches/cross-lfs/BOOK/temp-tools/sparc-chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/sparc-chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/sparc-chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
+<?dbhtml dir="temp-tools"?>
+<title>Constructing a Temporary Tools</title>
+<?dbhtml filename="chapter.html"?>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/expect.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/dejagnu.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/perl.xml"/>
+
+</chapter>

Added: branches/cross-lfs/BOOK/temp-tools/sparc64-chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/sparc64-chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/sparc64-chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
+<?dbhtml dir="temp-tools"?>
+<title>Constructing a Temporary Tools</title>
+<?dbhtml filename="chapter.html"?>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/expect.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/dejagnu.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/perl.xml"/>
+
+</chapter>

Deleted: branches/cross-lfs/BOOK/temp-tools/tcl.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/tcl.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/tcl.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -1,116 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-  <!ENTITY % general-entities SYSTEM "../general.ent">
-  %general-entities;
-]>
-<sect1 id="ch-temp-tools-tcl" role="wrap">
-<title>Tcl-&tcl-version;</title>
-<?dbhtml filename="tcl.html"?>
-
-<indexterm zone="ch-temp-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>
-
-<sect2 role="package"><title/>
-<para>The Tcl package contains the Tool Command Language.</para>
-
-<segmentedlist>
-<segtitle>&buildtime;</segtitle>
-<segtitle>&diskspace;</segtitle>
-<seglistitem><seg>0.9 SBU</seg><seg>23 MB</seg></seglistitem>
-</segmentedlist>
-
-<segmentedlist>
-<segtitle>&dependencies;</segtitle>
-<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
-GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
-</segmentedlist>
-
-</sect2>
-
-<sect2 role="installation">
-<title>Installation of Tcl</title>
-
-<para>This package and the next two (Expect and DejaGNU) are
-installed to support running the test suites for GCC and Binutils.
-Installing three packages for testing purposes may seem excessive, but
-it is very reassuring, if not essential, to know that the most
-important tools are working properly. Even if the test suites are not
-run in this chapter (they are not mandatory), these packages
-are required to run the test suites in <xref
-linkend="chapter-building-system"/>.</para>
-
-<para>Prepare Tcl for compilation:</para>
-
-<screen><userinput>cd unix
-./configure --prefix=/tools</userinput></screen>
-
-<para>Build the package:</para>
-
-<screen><userinput>make</userinput></screen>
-
-<para>To test the results, issue: <userinput>TZ=UTC make
-test</userinput>. The Tcl test suite is known to experience failures
-under certain host conditions that are not fully understood.
-Therefore, test suite failures here are not surprising, and are not
-considered critical. The <parameter>TZ=UTC</parameter> parameter sets
-the time zone to Coordinated Universal Time (UTC), also known as
-Greenwich Mean Time (GMT), but only for the duration of the test suite
-run. This ensures that the clock tests are exercised correctly.
-Details on the <envar>TZ</envar> environment variable is provided in
-<xref linkend="chapter-bootscripts"/>.</para>
-
-<para>Install the package:</para>
-
-<screen><userinput>make install</userinput></screen>
-
-
-<warning><para><emphasis>Do not</emphasis> remove the
-<filename class="directory">tcl&tcl-version;</filename> source directory yet, as the next package
-will need its internal headers.</para></warning>
-
-<para>Now make a necessary symbolic link:</para>
-
-<screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
-
-</sect2>
-
-<sect2 id="contents-tcl" role="content"><title>Contents of Tcl</title>
-
-<segmentedlist>
-<segtitle>Installed programs</segtitle>
-<segtitle>Installed library</segtitle>
-<seglistitem><seg>tclsh (link to tclsh8.4) and tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
-</segmentedlist>
-
-<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
-<?dbfo list-presentation="list"?>
-<?dbhtml list-presentation="table"?>
-
-<varlistentry id="tclsh8.4">
-<term><command>tclsh8.4</command></term>
-<listitem>
-<para>The Tcl command shell</para>
-<indexterm zone="ch-temp-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
-</listitem>
-</varlistentry>
-
-<varlistentry id="tclsh">
-<term><command>tclsh</command></term>
-<listitem>
-<para>A link to tclsh8.4</para>
-<indexterm zone="ch-temp-tools-tcl tclsh"><primary sortas="b-tclsh">tclsh</primary></indexterm>
-</listitem>
-</varlistentry>
-
-<varlistentry id="libtcl8.4.so">
-<term><filename class="libraryfile">libtcl8.4.so</filename></term>
-<listitem>
-<para>The Tcl library</para>
-<indexterm zone="ch-temp-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-</sect1>
-

Added: branches/cross-lfs/BOOK/temp-tools/x86-chapter.xml
===================================================================
--- branches/cross-lfs/BOOK/temp-tools/x86-chapter.xml	2005-05-12 04:21:21 UTC (rev 5299)
+++ branches/cross-lfs/BOOK/temp-tools/x86-chapter.xml	2005-05-12 04:21:52 UTC (rev 5300)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<chapter id="chapter-temporary-tools" xreflabel="Constructing a Temporary Tools">
+<?dbhtml dir="temp-tools"?>
+<title>Constructing a Temporary Tools</title>
+<?dbhtml filename="chapter.html"?>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/introduction.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/expect.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/dejagnu.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/perl.xml"/>
+
+</chapter>




More information about the lfs-book mailing list