Moved the host requirements page to the preface section of the book. (merged from trunk r6218)

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

6 files changed, 49 insertions, 43 deletions

diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml
index 6143b2c09..2e8cc75b0 100644
--- a/chapter01/changelog.xml
+++ b/chapter01/changelog.xml
@@ -87,6 +87,9 @@ First a summary, then a detailed log.</para>
 </itemizedlist>
 </listitem>
 
+<listitem><para>June 29th, 2005 [archaic]: Moved the host requirements page to
+the preface section of the book.</para></listitem>
+
 <listitem><para>June 28th, 2005 [archaic]: Switched from mounting /dev on a
 ramfs to a tmpfs.</para></listitem>
 
diff --git a/chapter05/chapter05.xml b/chapter05/chapter05.xml
index 9c567c530..aeaa22c99 100644
--- a/chapter05/chapter05.xml
+++ b/chapter05/chapter05.xml
@@ -9,7 +9,6 @@
 <?dbhtml filename="chapter05.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="hostreqs.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="toolchaintechnotes.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="binutils-pass1.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc-pass1.xml"/>
diff --git a/chapter05/hostreqs.xml b/chapter05/hostreqs.xml
deleted file mode 100644
index 310d450d1..000000000
--- a/chapter05/hostreqs.xml
+++ /dev/null
@@ -1,40 +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-tools-hostreqs">
-<title>Host System Requirements</title>
-<?dbhtml filename="hostreqs.html"?>
-
-<para>The host must be running at least a 2.6.2 kernel compiled with
-GCC-3.0 or higher. There are two main reasons for this high
-requirement. First, the Native POSIX Threading Library (NPTL)
-test suite will segfault if the host's kernel has not been compiled with
-GCC-3.0 or a later version. Secondly, the 2.6.2 or later version of
-the kernel is required for the use of Udev. Udev creates devices
-dynamically by reading from the <systemitem
-class="filesystem">sysfs</systemitem> file system. However, support
-for this filesystem has only recently been implemented in most of
-the kernel drivers. We must be sure that all critical system devices
-get created properly.</para>
-
-<para>In order to determine whether the host kernel meets the
-requirements outlined above, run the following command:</para>
-
-<screen><userinput>cat /proc/version</userinput></screen>
-
-<para>This will produce output similar to:</para>
-
-<screen><computeroutput>Linux version 2.6.2 (user@host) (gcc version 3.4.0) #1
-    Tue Apr 20 21:22:18 GMT 2004</computeroutput></screen>
-
-<para>If the results of the above command state that the host kernel
-was not compiled using a GCC-3.0 (or later) compiler, one will need to
-be compiled.  The host system will then need to be rebooted to use the
-newly compiled kernel. Instructions for compiling the kernel and
-configuring the boot loader (assuming the host uses GRUB) are located
-in <xref linkend="chapter-bootable"/>.</para>
-
-</sect1>
-
diff --git a/general.ent b/general.ent
index 75b2a171a..7a4ddabc7 100644
--- a/general.ent
+++ b/general.ent
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
-<!ENTITY version "TESTING-20050628">
-<!ENTITY releasedate "June 28, 2005">
+<!ENTITY version "TESTING-20050629">
+<!ENTITY releasedate "June 29, 2005">
 <!ENTITY milestone "6.1">
 <!ENTITY generic-version "testing"> <!-- Use "svn", "testing", or "x.y[-pre{x}]" -->
 
diff --git a/prologue/hostreqs.xml b/prologue/hostreqs.xml
new file mode 100644
index 000000000..16ac03da9
--- /dev/null
+++ b/prologue/hostreqs.xml
@@ -0,0 +1,43 @@
+<?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="pre-hostreqs">
+<title>Host System Requirements</title>
+<?dbhtml filename="hostreqs.html"?>
+
+<para>The host must be running at least a 2.6.2 kernel compiled with GCC-3.0 or
+higher. There are two main reasons for this requirement. First, the Native POSIX
+Threading Library (NPTL) test suite will segfault if the host's kernel has not
+been compiled with GCC-3.0 or a later version. Secondly, the 2.6.2 or later
+version of the kernel is required for the use of Udev. Udev creates devices
+dynamically by reading from the <systemitem
+class="filesystem">sysfs</systemitem> file system. However, support for this
+filesystem has only recently been implemented in most of the kernel drivers. We
+must be sure that all critical system devices get created properly.</para>
+
+<para>In order to determine whether the host kernel meets the
+requirements outlined above, run the following command:</para>
+
+<screen><userinput>cat /proc/version</userinput></screen>
+
+<para>This will produce output similar to:</para>
+
+<screen><computeroutput>Linux version 2.6.2 (user@host) (gcc version 3.4.0) #1
+    Tue Apr 20 21:22:18 GMT 2004</computeroutput></screen>
+
+<para>If the results of the above command do not state that the host kernel is
+either 2.6.2 (or later), or that it was not compiled using a GCC-3.0 (or later)
+compiler, one will need to be installed. There are two methods you can take to
+solve this. First, see if your Linux vendor provides a 2.6.2 (or later) kernel
+package. If so, you may wish to install it. If your vendor doesn't offer a 2.6.2
+(or later) kernel package, or you would prefer not to install it, then you can
+compile a 2.6 kernel yourself. Instructions for compiling the kernel and
+configuring the boot loader (assuming the host uses GRUB) are located in <xref
+linkend="chapter-bootable"/>. This second option can also been seen as a gauge
+of your current Linux skills. If this second requirement is too steep then the
+LFS book will not likely be much use to you at this time.</para>
+
+</sect1>
+
diff --git a/prologue/preface.xml b/prologue/preface.xml
index 79659f1d2..d2767c5d2 100644
--- a/prologue/preface.xml
+++ b/prologue/preface.xml
@@ -11,6 +11,7 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="foreword.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="audience.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prerequisites.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hostreqs.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="typography.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="organization.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="errata.xml"/>