first draft of tcl, expect, and dejagnu

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

3 files changed, 50 insertions, 12 deletions

diff --git a/chapter05/dejagnu-inst.xml b/chapter05/dejagnu-inst.xml
index 511573c56..0a948fdb9 100644
--- a/chapter05/dejagnu-inst.xml
+++ b/chapter05/dejagnu-inst.xml
@@ -3,9 +3,17 @@
 <sect2>
 <title>Installation of DejaGNU</title>
 
-<para><screen><userinput>./configure --prefix=/stage1
+<para>Prepare DejaGNU to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Build and install the package:</para>
+
+<para><screen><userinput>make
 make install</userinput></screen></para>
 
+<para>This completes the testing tools. We can now rebuild GCC and Binutils
+to link them against the new Glibc, and test them properly.</para>
 
 </sect2>
 
diff --git a/chapter05/expect-inst.xml b/chapter05/expect-inst.xml
index 5d6a714ee..f4f24687b 100644
--- a/chapter05/expect-inst.xml
+++ b/chapter05/expect-inst.xml
@@ -3,14 +3,27 @@
 <sect2>
 <title>Installation of Expect</title>
 
-<para><screen><userinput>patch -Np1 -i ../expect-&expect-version;.patch
-./configure --prefix=/stage1 --with-tcl=/stage1/lib --with-x=no
-make
+<para>First apply a patch:</para>
+
+<para><screen><userinput>patch -Np1 -i ../expect-&expect-version;.patch</userinput></screen></para>
+
+<para>This fixes a bug in Expect that can result in bogus failures during the
+GCC test suite run.</para>
+
+<para>Now prepare Expect to be compiled:</para>
+
+<para><screen><userinput>./configure --prefix=/stage1 --with-tcl=/stage1/lib --with-x=no</userinput></screen></para>
+
+<para>Build, test, and install the package:</para>
+
+<para><screen><userinput>make
 make test
 make install</userinput></screen></para>
 
-<para>You can remove the tcl&tcl-version; directory now as well as the
-expect directory.</para>
+<para>Note that also here some of the tests might fail, and that this is not a
+problem here either.</para>
+
+<para>You can now remove the build directories of both Tcl and Expect.</para>
 
 </sect2>
 
diff --git a/chapter05/tcl-inst.xml b/chapter05/tcl-inst.xml
index 523ce4463..e2e5da3a5 100644
--- a/chapter05/tcl-inst.xml
+++ b/chapter05/tcl-inst.xml
@@ -3,15 +3,32 @@
 <sect2>
 <title>Installation of TCL</title>
 
+<para>This package and the next two are only installed to be able to run the
+test suites for GCC and Binutils. Installing three packages just for for
+testing purposes may seem like overkill, but it is very reassuring, if not
+essential, to know that our most important tools are working properly.</para>
+
+<para>Prepare Tcl to be compiled:</para>
+
 <para><screen><userinput>cd unix
-./configure --prefix=/stage1
-make 
+./configure --prefix=/stage1</userinput></screen></para>
+
+<para>Build, test, and install the package:</para>
+
+<para><screen><userinput>make 
 make test
-make install
-ln -s tclsh8.4 /stage1/bin/tclsh</userinput></screen></para>
+make install</userinput></screen></para>
+
+<para>Note that some of the tests may fail, and that this is not a problem:
+the program will work well enough to be able to run the GCC and Binutils test
+suites.</para>
+
+<para>Make a link:</para>
+<para><screen><userinput>ln -s tclsh8.4 /stage1/bin/tclsh</userinput></screen></para>
 
-<para>Don't remove the tcl&tcl-version; directory yet, you need it for the
-next package installation.</para>
+<para>Do <emphasis>not remove</emphasis> the
+<filename>tcl&tcl-version;</filename> directory yet, as the next package will
+need its internal headers.</para>
 
 </sect2>