Trunk is now identical to Testing

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

5 files changed, 445 insertions, 89 deletions

diff --git a/chapter01/administrativa.xml b/chapter01/administrativa.xml
index adf02c2b0..6708e8d06 100644
--- a/chapter01/administrativa.xml
+++ b/chapter01/administrativa.xml
@@ -7,6 +7,86 @@
 <title>Resources</title>
 <?dbhtml filename="resources.html"?>
 
-<para>See testing</para>
+
+<sect2 id="ch-scatter-faq">
+<title>FAQ</title>
+
+<para>If during the building of the LFS system you encounter any
+errors, have any questions, or think there is a typo in the book,
+please start by consulting the Frequently Asked Questions (FAQ) at
+<ulink url="&faq-root;"/>.</para>
+</sect2>
+
+<sect2 id="ch-scatter-maillists" xreflabel="Chapter 1 - Mailing Lists">
+<title>Mailing Lists</title>
+
+<para>The <uri>linuxfromscratch.org</uri> server hosts a number of
+mailing lists used for the development of the LFS project. These lists
+include the main development and support lists, among others.</para> 
+
+<para>For information on the different lists, how to subscribe, archive
+locations, and additional information, visit
+<ulink url="&lfs-root;mail.html"/>.</para>
+</sect2>
+
+<sect2 id="ch-scatter-irc">
+<title>IRC</title>
+
+<para>Several members of the LFS community offer assistance on our
+community Internet Relay Chat (IRC) network. Before using this
+support, please make sure that your question is not already answered in the LFS
+FAQ or the mailing list archives. You can find the IRC network at
+<uri>irc.linuxfromscratch.org</uri>, <uri>irc.linux-phreak.net</uri>
+or <uri>irc.lfs-matrix.de</uri>. 
+The support channel is named #LFS-support.</para>
+</sect2>
+
+<sect2 id="ch-scatter-newsserver">
+<title>News Server</title>
+
+<para>The mailing lists hosted at <uri>linuxfromscratch.org</uri> are
+also accessible via the Network News Transfer Protocol (NNTP) server.
+All messages posted to a mailing list are copied to the corresponding
+newsgroup, and vice versa.</para>
+
+<para>The news server is located at
+<uri>news.linuxfromscratch.org</uri>.</para>
+</sect2>
+
+<sect2 id="ch-scatter-wiki">
+<title>Wiki</title>
+
+<para>For more information on packages, updated versions, tweaks, and
+personal experiences, see the LFS Wiki at <ulink url="&wiki-root;"/>.
+Users can also add information there to help others with their future
+LFS activities.</para>
+</sect2>
+
+<sect2 id="ch-scatter-references">
+<title>References</title>
+
+<para>For additional information on the packages, useful tips are
+available at
+<ulink
+url="http://www.linuxfromscratch.org/~matthew/LFS-references.html"/>.</para>
+</sect2>
+
+
+<sect2 id="ch-scatter-mirrors" xreflabel="Chapter 1 - Mirror sites">
+<title>Mirror Sites</title>
+
+<para>The LFS project has a number of world-wide mirrors to make
+accessing the website and downloading the required packages more
+convenient. Please visit the LFS website at <ulink url="&lfs-root;"/>
+for a list of current mirrors.</para>
+</sect2>
+
+<sect2 id="ch-scatter-contactinfo">
+<title>Contact Information</title>
+
+<para>Please direct all your questions and comments to one of the LFS mailing
+lists (see above).</para>
+</sect2>
 
 </sect1>
+
diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml
index df7e83f11..1dc36c365 100644
--- a/chapter01/askforhelp.xml
+++ b/chapter01/askforhelp.xml
@@ -7,6 +7,110 @@
 <title>Help</title>
 <?dbhtml filename="askforhelp.html"?>
 
-<para>See testing</para>
+<para>If an issue or a question is encountered while working
+through this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>.
+Questions are often already answered there. If your question is
+not answered on this page, try to find the source of the problem. The
+following hint will give you some guidance for troubleshooting: <ulink
+url="&hints-root;errors.txt"/>.</para>
+
+<para>We also have a wonderful LFS community that is willing to offer
+assistance through IRC and the mailing lists (see the <xref
+linkend="ch-scatter-administrativa"/> section of this book). In order
+to assist with diagnosing and solving the problem, please include
+all relevant information in your request for help.</para>
+
+<sect2>
+<title>Things to Mention</title>
+ 
+<para>Apart from a brief explanation of the problem being experienced,
+the essential things to include in any request for help are:</para>
+
+<itemizedlist>
+<listitem><para>The version of the book being used (in this case
+&version;)</para></listitem>
+<listitem><para>The host distribution and version being used to
+create LFS</para></listitem>
+<listitem><para>The package or section the problem was encountered in</para></listitem>
+<listitem><para>The exact error message or symptom being received</para></listitem>
+<listitem><para>Note whether you have deviated from the book at all </para></listitem>
+</itemizedlist>
+
+<note><para>Deviating from this book does <emphasis>not</emphasis>
+mean that we will not help you. After all, LFS is about personal
+preference. Being upfront about any changes to the established
+procedure helps us evaluate and determine possible causes of your
+problem.</para></note>
+</sect2>
+
+<sect2>
+<title>Configure Problems</title>
+
+<para>If something goes wrong during the stage where the configure
+script is run, review the <filename>config.log</filename> file. This
+file may contain errors encountered during configure which were not
+printed to the screen. Include those relevant lines if you need to ask
+for help.</para>
+</sect2>
+
+<sect2>
+<title>Compile Problems</title>
+
+<para>Both the screen output and the contents of various files are
+useful in determining the cause of compile issues. The screen output
+from the <command>./configure</command> script and the 
+<command>make</command> run can be helpful. It
+is not necessary to include the entire output, but do include enough
+of the relevant information. Below is an example of the type of
+information to include from the screen output from <command>make</command>:</para>
+
+<screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\"
+-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" 
+-DLIBDIR=\"/mnt/lfs/usr/lib\"
+-DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I.
+-g -O2 -c getopt1.c
+gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o 
+expand.o file.o function.o getopt.o implicit.o job.o main.o 
+misc.o read.o remake.o rule.o signame.o variable.o vpath.o 
+default.o remote-stub.o version.o opt1.o
+-lutil job.o: In function `load_too_high':
+/lfs/tmp/make-3.79.1/job.c:1565: undefined reference 
+to `getloadavg'
+collect2: ld returned 1 exit status
+make[2]: *** [make] Error 1
+make[2]: Leaving directory `/lfs/tmp/make-3.79.1'
+make[1]: *** [all-recursive] Error 1
+make[1]: Leaving directory `/lfs/tmp/make-3.79.1'
+make: *** [all-recursive-am] Error 2</computeroutput></screen>
+
+<para>In this case, many people would just include the bottom
+section:</para>
+
+<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen>
+
+<para>This is not enough information to properly diagnose the problem
+because it only notes that something went wrong, not
+<emphasis>what</emphasis> went wrong.  The entire section, as in the
+example above, is what should be saved because it includes the command
+that was executed and the associated error message(s).</para>
+
+<para>An excellent article about asking for help on the Internet is
+available online at <ulink
+url="http://catb.org/~esr/faqs/smart-questions.html"/>.  Read and
+follow the hints in this document to increase the likelihood of getting
+the help you need.</para>
+</sect2>
+
+<sect2>
+<title>Test Suite Problems</title>
+
+<para>Many packages provide a test suite which, depending on the
+importance of the package, should be run. Sometimes packages will
+generate false or expected failures. If these errors are encountered,
+check the LFS Wiki page at <ulink url="&wiki-root;"/> to see if we have
+noted and investigated these issues. If these issues are noted and
+addressed, there is no need to be concerned.</para>
+</sect2>
 
 </sect1>
+
diff --git a/chapter01/bootcd.xml b/chapter01/bootcd.xml
index 773f76c9b..47542fc6f 100644
--- a/chapter01/bootcd.xml
+++ b/chapter01/bootcd.xml
@@ -7,7 +7,60 @@
 <title>About the Included CD</title>
 <?dbhtml filename="bootcd.html"?>
 
-<para>See testing</para>
+<para>For your convenience, we have included a CD with this book that
+contains the source packages needed for creating a Linux From Scratch
+system.  The CD is bootable and provides a stable working environment
+for building LFS.  This book refers to this system as the
+<quote>host system.</quote>  The CD images are actively maintained and
+updated versions can be found at
+<ulink url="ftp://ftp.lfs-matrix.net/pub/lfs-livecd/"/></para>
+
+<para>In addition to the tools required to build LFS, the host system
+on the CD has a number of other helpful tools installed:</para>
+
+<itemizedlist>
+	<listitem><para>An HTML version of this book</para></listitem>
+	<listitem><para>The X Window System Environment</para></listitem>
+	<listitem>
+		<para>Web Tools</para>
+		<itemizedlist>
+			<listitem><para>Wget (command line file retriever)</para></listitem>
+			<listitem><para>Lynx (text web browser)</para></listitem>
+			<listitem><para>Irssi (console IRC client)</para></listitem>
+			<listitem><para>Firefox (graphical web browser)</para></listitem>
+			<listitem><para>Xchat (X-based IRC client)</para></listitem>
+		</itemizedlist>
+	</listitem>
+
+	<listitem>
+		<para>Text Editors</para>
+		<itemizedlist>
+			<listitem><para>Vim</para></listitem>
+			<listitem><para>Nano</para></listitem>
+		</itemizedlist>
+	</listitem>
+
+	<listitem>
+		<para>Network Tools</para>
+		<itemizedlist>
+		<listitem><para>SSH Server and Client</para></listitem>
+		<listitem><para>NFS Server and Client</para></listitem>
+		<listitem><para>Smbmount (mount.cifs) for Windows shares</para></listitem>
+		<listitem><para>Subversion</para></listitem>
+		<listitem><para>Dhcpcd (DHCP client)</para></listitem>
+	</itemizedlist>
+	</listitem>
+
+	<listitem>
+		<para>Filesystem Programs</para>
+		<itemizedlist>
+			<listitem><para>Reiserfsprogs</para></listitem>
+			<listitem><para>Xfsprogs</para></listitem>
+		</itemizedlist>
+	</listitem>
+
+	<listitem><para>nALFS - A tool for automating LFS builds</para></listitem>
+</itemizedlist>
 
 </sect1>
 
diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml
index 1721d7913..c0f2ba9ed 100644
--- a/chapter01/changelog.xml
+++ b/chapter01/changelog.xml
@@ -3,7 +3,7 @@
   <!ENTITY % general-entities SYSTEM "../general.ent">
   %general-entities;
 ]>
-<sect1 id="ch-scatter-changelog" condition="no-print">
+<sect1 id="ch-scatter-changelog" condition="html">
 <title>Changelog</title>
 <?dbhtml filename="changelog.html"?>
 
@@ -12,141 +12,188 @@
 version is probably already available. To find out, please check one of the
 mirrors via <ulink url="&lfs-root;"/>.</para>
 
-<para>Below is a list of differences between the Testing and Unstable versions
-of the LFS Book.</para>
+<para>Below is a list of changes made since the previous release of the book,
+first a summary, then a detailed log.</para>
 
 <itemizedlist>
 
 <listitem><para>Upgraded to:</para>
 <itemizedlist>
-<listitem><para>automake-1.9.5</para></listitem>
-<listitem><para>e2fsprogs-1.36</para></listitem>
-<listitem><para>expect-5.43.0</para></listitem>
-<listitem><para>file-4.13</para></listitem>
-<listitem><para>findutils-4.2.17</para></listitem>
-<listitem><para>glibc-2.3.4</para></listitem>
-<listitem><para>grub-0.96</para></listitem>
-<listitem><para>lfs-bootscripts-3.1.0</para></listitem>
-<listitem><para>libol-0.3.15</para></listitem>
-<listitem><para>libtool-1.5.14</para></listitem>
-<listitem><para>linux-libc-headers-2.6.10.0</para></listitem>
-<listitem><para>procps-3.2.5</para></listitem>
-<listitem><para>sed-4.1.4</para></listitem>
-<listitem><para>shadow-4.0.7</para></listitem>
-<listitem><para>syslog-ng-1.6.6</para></listitem>
-<listitem><para>util-linux-2.12q</para></listitem>
+<listitem><para>Automake 1.9.5</para></listitem>
+<listitem><para>Binutils 2.15.94.0.2</para></listitem>
+<listitem><para>Bison 2.0</para></listitem>
+<listitem><para>E2fsprogs 1.36</para></listitem>
+<listitem><para>Expect 5.43.0</para></listitem>
+<listitem><para>File 4.13</para></listitem>
+<listitem><para>Findutils 4.2.17</para></listitem>
+<listitem><para>GCC 3.4.3</para></listitem>
+<listitem><para>Glibc 20041011</para></listitem>
+<listitem><para>Grep 2.5.1a</para></listitem>
+<listitem><para>Grub 0.96</para></listitem>
+<listitem><para>Iana-Etc 1.03</para></listitem>
+<listitem><para>Iproute2 2.6.9-041019</para></listitem>
+<listitem><para>LFS-Bootscripts 3.1.0</para></listitem>
+<listitem><para>Libtool 1.5.14</para></listitem>
+<listitem><para>Linux 2.6.10</para></listitem>
+<listitem><para>Linux-libc-headers 2.6.10.0</para></listitem>
+<listitem><para>Man 1.5p</para></listitem>
+<listitem><para>Man-pages 2.01</para></listitem>
+<listitem><para>Module-init-tools 3.1</para></listitem>
+<listitem><para>Perl 5.8.6</para></listitem>
+<listitem><para>Procps 3.2.5</para></listitem>
+<listitem><para>Sed 4.1.4</para></listitem>
+<listitem><para>Shadow 4.0.7</para></listitem>
+<listitem><para>Sysvinit 2.86</para></listitem>
+<listitem><para>Tar 1.15.1</para></listitem>
+<listitem><para>Texinfo 4.8</para></listitem>
+<listitem><para>Tcl 8.4.9</para></listitem>
+<listitem><para>Udev 050</para></listitem>
+<listitem><para>Util-linux 2.12q</para></listitem>
+<listitem><para>Zlib 1.2.2</para></listitem>
 </itemizedlist>
 </listitem>
 
 <listitem><para>Added:</para>
 <itemizedlist>
-<listitem><para>bash-3.0-fixes-3.patch</para></listitem>
+<listitem><para>bash-3.0-fixes-1.patch</para></listitem>
+<listitem><para>bash-3.0-avoid_WCONTINUED-1.patch</para></listitem>
+<listitem><para>Hotplug 2004_09_23</para></listitem>
 <listitem><para>iproute2-2.6.9_041019-find_update-1.patch</para></listitem>
+<listitem><para>Libol 0.3.15</para></listitem>
+<listitem><para>linux-2.6.10-security_fix-1.patch</para></listitem>
+<listitem><para>Syslog-ng 1.6.6</para></listitem>
+<listitem><para>util-linux-2.12p-cramfs-1.patch</para></listitem>
+<listitem><para>vim-6.0-security_fix-1.patch</para></listitem>
 </itemizedlist>
 </listitem>
-
+ 
 <listitem><para>Removed:</para>
 <itemizedlist>
-<listitem><para>bash-3.0-fixes-1.patch</para></listitem>
+<listitem><para>bash-3.0-display_wrap-1.patch</para></listitem>
+<listitem><para>man-1.5o1-80cols-1.patch</para></listitem>
+<listitem><para>Sysklogd 1.4.1</para></listitem>
+<listitem><para>sysvinit-2.85-proclen-1.patch</para></listitem>
+<listitem><para>texinfo-4.7-segfault-1.patch</para></listitem>
+<listitem><para>util-linux-2.12b-sfdisk-1.patch</para></listitem>
+<listitem><para>zlib-1.2.1-security-1.patch</para></listitem>
 </itemizedlist>
 </listitem>
 
-<listitem><para>February 13, 2005 [matt]: Add a link to BLFS' index of
-packages requiring kernel configuration.  Fixes bug 1028.</para></listitem>
+<listitem><para>February 19, 2005 [gerard]: Synchronized Testing
+branch with current Unstable/Trunk. Move Testing branch to Trunk and
+discontinue Testing branch as per lfs-dev discussion on branch
+changes.</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Fix bug 1030 by moving the <quote>Get
-Counted</quote> section to after the user has rebooted for the first time.
-Fixes bug 1030.</para></listitem>
+<listitem><para>February 5, 2005 [matt]: Copy hotplug's pnp.distmap file to
+silence its warnings.  Also tidy up some explanatory text</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to glibc-2.3.4</para>
-</listitem>
+<listitem><para>January 29, 2005 [matt]: Upgraded to sed-4.1.4</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to grub-0.96</para>
+<listitem><para>January 29, 2005 [matt]: Upgraded to procps-3.2.5</para>
 </listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to e2fsprogs-1.36</para>
+<listitem><para>January 29, 2005 [matt]: Upgraded to shadow-4.0.7</para>
 </listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to findutils-4.2.17</para>
+<listitem><para>January 29, 2005 [matt]: Upgraded to util-linux-2.12q.</para>
 </listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to expect-5.43.0</para>
-</listitem>
+<listitem><para>January 27, 2005 [matt]: Added a warning that the
+<filename class="symlink">/usr/src/linux</filename> symlink shouldn't be
+created.  Fixes bug 1012.</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to libtool-1.5.14</para>
-</listitem>
+<listitem><para>January 27, 2005 [matt]: Added link to the live-cd FTP
+location.  Fixes bug 1014.</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to automake-1.9.5</para>
-</listitem>
+<listitem><para>January 27, 2005 [matt]: Added bison, flex and m4 to binutils
+dependency list.  Fixes Bug 1018.</para></listitem>
 
-<listitem><para>February 13, 2005 [matt]: Upgraded to file-4.13</para>
-</listitem>
+<listitem><para>January 27, 2005 [manuel]: Updated to gcc-3.4.3-specs-2.patch.</para></listitem>
 
-<listitem><para>February 5, 2005 [matt]: Added a space to the toolchain
-readjustment <command>perl</command> command.  This stops the specs file being
-incorrectly modified if the command is run more than once. Fixes bug 1023.
-</para></listitem>
+<listitem><para>January 19, 2005 [jeremy]: Added an extra symlink for
+libgcc_s.so to chapter 6 - this never migrated from unstable until now.</para></listitem>
 
-<listitem><para>February 5, 2005 [matt]: Copy hotplug's pnp.distmap file to
-silence its warnings</para></listitem>
+<listitem><para>January 9, 2005 [matt]: Added a security patch for the kernel</para></listitem>
 
-<listitem><para>February 5, 2005 [matt]: Upgraded to syslog-ng-1.6.6</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Added a security patch for vim</para></listitem>
 
-<listitem><para>February 5, 2005 [matt]: Upgraded to libol-0.3.15</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to man-1.5p</para></listitem>
 
-<listitem><para>January 29th, 2005 [matt]: Upgraded to findutils 4.2.15</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to texinfo-4.8</para></listitem>
 
-<listitem><para>January 28th, 2005 [matt]: Upgraded to sed-4.1.4</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to util-linux-2.12p</para></listitem>
 
-<listitem><para>January 27th, 2005 [matt]: Upgraded to findutils 4.2.14</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to udev-050</para></listitem>
 
-<listitem><para>January 27th, 2005 [matt]: Upgraded to sed-4.1.3</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to tcl-8.4.9</para></listitem>
 
-<listitem><para>January 27th, 2005 [matt]: Upgraded to procps-3.2.5</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to tar-1.15.1</para></listitem>
 
-<listitem><para>January 27th, 2005 [matt]: Upgraded to shadow-4.0.7</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to perl-5.8.6</para></listitem>
 
-<listitem><para>January 27th, 2005 [matt]: Upgraded to util-linux-2.12q</para>
-</listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to man-pages-2.01</para></listitem>
+
+<listitem><para>January 9, 2005 [matt]: Upgraded to linux-libc-headers-2.6.10.0</para></listitem>
+
+<listitem><para>January 9, 2005 [matt]: Upgraded to linux-2.6.10</para></listitem>
+
+<listitem><para>January 9, 2005 [matt]: Upgraded to gcc-3.4.3</para></listitem>
+
+<listitem><para>January 9, 2005 [matt]: Upgraded to bison-2.0</para></listitem>
 
-<listitem><para>January 9th, 2005 [jeremy]: Removed --enable-shared from libol,
-since the shared library is installed by default for this package - thanks
-Archaic</para></listitem>
+<listitem><para>January 9, 2005 [matt]: Upgraded to autoconf-1.9.4</para></listitem>
 
-<listitem><para>January 5th, 2005 [jeremy]: Upgraded to findutils 4.2.11</para></listitem>
+<listitem><para>January 5, 2005 [jeremy]: Minor textual correction in network
+configuration, since iproute will not recognize the old eth0:1 format for
+ip aliasing. Closes bug 1013.</para></listitem>
 
-<listitem><para>December 31st, 2004 [jeremy]: Oops - forgot to remove the
-separate targets for hotplug and syslog-ng - fixed.</para></listitem>
+<listitem><para>January 5, 2005 [jeremy]: Added the --disable-selinux parameter
+to Ch 5 glibc.  Allows building from hosts which use SELinux functionality,
+like Fedora Core 3</para></listitem>
 
-<listitem><para>December 31st, 2004 [jeremy]: Upgrade to LFS-Bootscripts 3.1.0</para></listitem>
+<listitem><para>December 25, 2004 [jeremy]: Added text suggested by MSB,
+closing Bug 943</para></listitem>
 
-<listitem><para>December 30th, 2004 [jeremy]: Added Archaic's sed to stop
-installation of shadow's groups binary, as well as it's man page.</para></listitem>
+<listitem><para>December 25, 2004 [jeremy]: Upgraded binutils to 2.14.94.0.2 -
+should fix the TLS strip issue that's been seen, at least on X86</para></listitem>
 
-<listitem><para>December 25th, 2004 [jeremy]: Upgrade to glibc snapshot
-of 20041220</para></listitem>
+<listitem><para>December 22, 2004 [manuel]: Readded to chapter09/reboot.xml a para lost
+from version 5.1.</para></listitem>
 
-<listitem><para>December 19th, 2004 [jeremy]: Updated GCC-testresults link to
-be appropriate for GCC 3.4.3</para></listitem>
+<listitem><para>December 20, 2004 [manuel]: Made Grub's configuration location 
+FHS compliant.</para></listitem>
 
-<listitem><para>December 6th, 2004 [jim]: Fixes a few typo's done by me.
-Added a patch for IPRoute2 to fix usage with the newer findutils.
-Updated Readline and Zlib library location changes.
-Bumped findutils to 4.2.9 and util-linux 2.12j.
-Used the same methodology used on zlib and readline on shadow.</para></listitem>
+<listitem><para>December 19, 2004 [manuel]: Added the irc.lfs-matrix.de IRC server.</para></listitem>
 
-<listitem><para>December 3rd, 2004 [jim]: Changed readline and zlib instructions
-to use --libdir for the libraries. Bumped perl to 5.8.6. Corrected wording in
-readline.</para></listitem>
+<listitem><para>December 5, 2004 [jeremy]: Added the DOCBOOKTOMAN parameter
+to Module-init-utils - without this, compilation fails.  Thanks Boris Buegling</para></listitem>
+
+<listitem><para>December 2, 2004 [jeremy]: Removed the old display_wrap bash
+patch, in favor of the newer fixes patch, and added the avoid_WCONTINUED
+patch as well</para></listitem>
+
+<listitem><para>December 2, 2004 [jeremy]: Upgraded to TCL 8.4.8, Grep 2.5.1a
+Util-linux 2.12i, Iana-etc 1.03, File 4.12, Module-init-tools 3.1, Procps 3.2.4
+</para></listitem>
+
+<listitem><para>December 2, 2004 [jeremy]: Migrated change from unstable to
+build Glibc against sanitized linux-libc-headers instead of raw kernel headers,
+bringing us more in line with what the kernel developers think should be
+happening.</para></listitem>
+
+<listitem><para>December 1, 2004 [jeremy]: Dropped Udev from being built in
+Chapter 5, in favor of creating a minimal set of devices at the beginning
+of Chapter 6.  All devices are created after the installation of Udev near
+the end of Chapter 6</para></listitem>
+
+<listitem><para>December 1, 2004 [jeremy]: Upgraded to Automake 1.9.3,
+Binutils 2.15.92.0.2, Findutils 4.2.3, GCC 3.4.2, Glibc 20041011, Iana-Etc 1.02
+Iproute2 2.6.9-041019, LFS-Bootscripts 2.2.3, Libtool 1.5.10, Linux 2.6.9
+Linux-libc-headers 2.6.9.1, Man 1.5o1, Man-pages 1.70, Shadow 4.0.6,
+Udev 046, Zlib 1.2.2, Hotplug 2004_09_23, Libol 0.3.14, Syslog-ng 1.6.5</para></listitem>
 
 </itemizedlist>
 
+<para>Branch frozen for LFS 6.0 as of October 10, 2004</para>
+
 </sect1>
diff --git a/chapter01/how.xml b/chapter01/how.xml
index 98828fc8a..b2390fb48 100644
--- a/chapter01/how.xml
+++ b/chapter01/how.xml
@@ -7,6 +7,78 @@
 <title>How to Build an LFS System</title>
 <?dbhtml filename="how.html"?>
 
-<para>See testing</para>
+<para>The LFS system will be built by using a previously installed
+Linux distribution (such as Debian, Mandrake, Red Hat, or SuSE). This
+existing Linux system (the host) will be used as a starting point to
+provide necessary programs, including a compiler, linker, and shell,
+to build the new system. Select the <quote>development</quote> option
+during the distribution installation to be able to access these
+tools.</para>
+
+<para><xref linkend="chapter-partitioning"/> of this book describes how
+to create a new Linux native partition and file system, the place
+where the new LFS system will be compiled and installed. <xref
+linkend="chapter-getting-materials"/> explains which packages and
+patches need to be downloaded to build an LFS system and how to store
+them on the new file system. <xref linkend="chapter-final-preps"/>
+discusses the setup for an appropriate work environment. Please read
+<xref linkend="chapter-final-preps"/> carefully as it explains several
+important issues the developer should be aware of before beginning to
+work through <xref linkend="chapter-temporary-tools"/> and
+beyond.</para>
+
+<para><xref linkend="chapter-temporary-tools"/> explains the
+installation of a number of packages that will form the basic
+development suite (or toolchain) which is used to build the actual
+system in <xref linkend="chapter-building-system"/>. Some of these
+packages are needed to resolve circular dependencies&mdash;for example,
+to compile a compiler, you need a compiler.</para>
+
+<para><xref linkend="chapter-temporary-tools"/> also shows the user how
+to build a first pass of the toolchain, including Binutils and GCC
+(first pass basically means these two core packages will be
+re-installed a second time). The programs from these packages will be
+linked statically in order to be used independently of the host
+system. The next step is to build Glibc, the C library. Glibc will be
+compiled by the toolchain programs built in the first pass. Then, a
+second pass of the toolchain will be built. This time, the toolchain
+will be dynamically linked against the newly built Glibc. The
+remaining <xref linkend="chapter-temporary-tools"/> packages are built
+using this second pass toolchain. When this is done, the LFS
+installation process will no longer depend on the host distribution,
+with the exception of the running kernel.</para>
+
+<para>While this may initially seem like a lot of work to get away
+from a host distribution, a full technical explanation is provided at
+the beginning of <xref linkend="chapter-temporary-tools"/>, 
+including notes on the differences between
+statically and dynamically-linked programs.</para>
+
+<para>In <xref linkend="chapter-building-system"/>, the full LFS system is
+built. The chroot (change root) program is used to enter a virtual
+environment and start a new shell whose root directory will be set to
+the LFS partition. This is very similar to rebooting and instructing
+the kernel to mount the LFS partition as the root partition. The
+system does not actually reboot, but instead chroots because creating a
+bootable system requires additional work which is not necessary just
+yet. The major advantage is that <quote>chrooting</quote> allows the
+builder to continue using the host while LFS is being built. While
+waiting for package compilation to complete, a user can switch to a
+different virtual console (VC) or X desktop and continue using the
+computer as normal.</para>
+
+<para>To finish the installation, the bootscripts are set up in <xref
+linkend="chapter-bootscripts"/>, and the kernel and boot loader are set
+up in <xref linkend="chapter-bootable"/>. <xref
+linkend="chapter-finalizing"/> contains information on furthering the
+LFS experience beyond this book.  After the steps in this book have
+been implemented, the computer will be ready to reboot into the new
+LFS system.</para>
+
+<para>This is the process in a nutshell. Detailed information on each
+step is discussed in the following chapters and package descriptions.
+Items that may seem complicated will be clarified, and everything will
+fall into place as the developer embarks on the LFS adventure.</para>
 
 </sect1>
+