aboutsummaryrefslogtreecommitdiffstats
path: root/chapter01
diff options
context:
space:
mode:
authorManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-11 12:02:10 +0000
committerManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-11 12:02:10 +0000
commit13a9dc2d62c5a1fa1c354cdfa54ce18c8f5ff67f (patch)
tree8e3cf55efdc215bd3300c1f8ea799ded1cb88ff1 /chapter01
parent895a63773759de2d1a063fea24b3dc53a53f79ec (diff)
Indented chapter01 except changelog.xml.
Renamed administrativa.xml to resources.xml. Standarized the ID values. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7265 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter01')
-rw-r--r--chapter01/administrativa.xml83
-rw-r--r--chapter01/askforhelp.xml188
-rw-r--r--chapter01/chapter01.xml21
-rw-r--r--chapter01/how.xml147
-rw-r--r--chapter01/livecd.xml146
-rw-r--r--chapter01/resources.xml91
6 files changed, 371 insertions, 305 deletions
diff --git a/chapter01/administrativa.xml b/chapter01/administrativa.xml
deleted file mode 100644
index 52aea6168..000000000
--- a/chapter01/administrativa.xml
+++ /dev/null
@@ -1,83 +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-scatter-administrativa">
-<title>Resources</title>
-<?dbhtml filename="resources.html"?>
-
-
-<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)
-that is located 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. If the FAQ does not solve the
-problem you are having, the next step would be to search the mailing lists at
-<ulink url="&lfs-root;search.html"/>.</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>
-
-<!-- Remove until such time as we have our own News Server, JH 20060105
-<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-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>.
-The support channel is named #LFS-support.</para>
-</sect2>
-
-<sect2 id="ch-scatter-references">
-<title>References</title>
-
-<para>For additional information on the packages, useful tips are
-available in the LFS Package Reference page located 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;mirrors.html"/> 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 fa6ddccaa..f5f550318 100644
--- a/chapter01/askforhelp.xml
+++ b/chapter01/askforhelp.xml
@@ -1,87 +1,101 @@
<?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" [
+<!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="prepare-askforhelp">
-<title>Help</title>
-<?dbhtml filename="askforhelp.html"?>
-
-<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>If you cannot find your problem listed in the FAQ, search the mailing
-lists at <ulink url="&lfs-root;search.html"/>.</para>
-
-<para>We also have a wonderful LFS community that is willing to offer assistance
-through the mailing lists and IRC (see the <xref
-linkend="ch-scatter-administrativa"/> section of this book). However, we get
-several support questions everyday and many of them can be easily answered by
-going to the FAQ and by searching the mailing lists first. So for us to offer
-the best assistance possible, you need to do some research on your own first.
-That allows us to focus on the more unusual support needs. If your searches do
-not produce a solution, please include all relevant information (mentioned
-below) 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 Script Problems</title>
-
-<para>If something goes wrong while running the <command>configure</command>
-script, review the <filename>config.log</filename> file. This file may
-contain errors encountered during <command>configure</command> which were not
-printed to the screen. Include the <emphasis>relevant</emphasis> lines if you
-need to ask for help.</para>
-</sect2>
-
-<sect2>
-<title>Compilation Problems</title>
-
-<para>Both the screen output and the contents of various files are
-useful in determining the cause of compilation problems. 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>
+
+<sect1 id="ch-intro-askforhelp">
+ <?dbhtml filename="askforhelp.html"?>
+
+ <title>Help</title>
+
+ <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>If you cannot find your problem listed in the FAQ, search the mailing
+ lists at <ulink url="&lfs-root;search.html"/>.</para>
+
+ <para>We also have a wonderful LFS community that is willing to offer
+ assistance through the mailing lists and IRC (see the <xref
+ linkend="ch-intro-resources"/> section of this book). However,
+ we get several support questions everyday and many of them can be easily
+ answered by going to the FAQ and by searching the mailing lists first.
+ So for us to offer the best assistance possible, you need to do some
+ research on your own first. That allows us to focus on the more unusual
+ support needs. If your searches do not produce a solution, please include
+ all relevant information (mentioned below) 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 Script Problems</title>
+
+ <para>If something goes wrong while running the <command>configure</command>
+ script, review the <filename>config.log</filename> file. This file may
+ contain errors encountered during <command>configure</command> which were
+ not printed to the screen. Include the <emphasis>relevant</emphasis> lines
+ if you need to ask for help.</para>
+
+ </sect2>
+
+ <sect2>
+ <title>Compilation Problems</title>
+
+ <para>Both the screen output and the contents of various files are useful
+ in determining the cause of compilation problems. 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\"
+-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
+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
+/lfs/tmp/make-3.79.1/job.c:1565: undefined reference
to `getloadavg'
collect2: ld returned 1 exit status
make[2]: *** [make] Error 1
@@ -90,23 +104,23 @@ 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>
+ <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>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>
+ <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>
-</sect1>
+ </sect2>
+</sect1>
diff --git a/chapter01/chapter01.xml b/chapter01/chapter01.xml
index 15019e65d..3906cf0aa 100644
--- a/chapter01/chapter01.xml
+++ b/chapter01/chapter01.xml
@@ -1,17 +1,20 @@
<?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" [
+<!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-intro" xreflabel="Chapter 1">
-<?dbhtml dir="chapter01"?>
-<title>Introduction</title>
-<?dbhtml filename="chapter01.html"?>
+ <?dbhtml dir="chapter01"?>
+ <?dbhtml filename="chapter01.html"?>
+
+ <title>Introduction</title>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="how.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="changelog.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="administrativa.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askforhelp.xml"/>
-<!--<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="livecd.xml"/>-->
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="how.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="changelog.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="resources.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askforhelp.xml"/>
+ <!--<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="livecd.xml"/>-->
</chapter>
diff --git a/chapter01/how.xml b/chapter01/how.xml
index 55d1447d6..6c1c3b26f 100644
--- a/chapter01/how.xml
+++ b/chapter01/how.xml
@@ -1,88 +1,89 @@
<?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" [
+<!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-scatter-how">
-<title>How to Build an LFS System</title>
-<?dbhtml filename="how.html"?>
-<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>
+<sect1 id="ch-intro-how">
+ <?dbhtml filename="how.html"?>
-<para>As an alternative to installing an entire separate distribution onto your
-machine, you may wish to use the Linux From Scratch LiveCD. The CD works well as
-a host system, providing all the tools you need to successfully follow the
-instructions in this book. Additionally, it contains all the source packages,
-patches and a copy of this book. So once you have the CD, no network connection
-or additional downloads are necessary. For more information about the LFS LiveCD
-or to download a copy, visit <ulink url="&livecd-root;"/>.</para>
+ <title>How to Build an LFS System</title>
-<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 working 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>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-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>As an alternative to installing an entire separate distribution
+ onto your machine, you may wish to use the Linux From Scratch LiveCD.
+ The CD works well as a host system, providing all the tools you need
+ to successfully follow the instructions in this book. Additionally,
+ it contains all the source packages, patches and a copy of this book.
+ So once you have the CD, no network connection or additional downloads
+ are necessary. For more information about the LFS LiveCD or to download
+ a copy, visit <ulink url="&livecd-root;"/>.</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 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><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 working 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>This effort to isolate the new system from the host distribution may seem
-excessive, but a full technical explanation is provided in
-<xref linkend="ch-tools-toolchaintechnotes"/>.</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>In <xref linkend="chapter-building-system"/>, the full LFS system is
-built. The <command>chroot</command> (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 <command>chroot</command>'s 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><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 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>To finish the installation, the LFS-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 effort to isolate the new system from the host distribution may
+ seem excessive, but a full technical explanation is provided in
+ <xref linkend="ch-tools-toolchaintechnotes"/>.</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 reader embarks on the LFS adventure.</para>
+ <para>In <xref linkend="chapter-building-system"/>, the full LFS system is
+ built. The <command>chroot</command> (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 <command>chroot</command>'s 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>
-</sect1>
+ <para>To finish the installation, the LFS-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 reader embarks on the LFS adventure.</para>
+</sect1>
diff --git a/chapter01/livecd.xml b/chapter01/livecd.xml
index d76e58506..68c408c55 100644
--- a/chapter01/livecd.xml
+++ b/chapter01/livecd.xml
@@ -1,66 +1,106 @@
<?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" [
+<!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="prepare-livecd">
-<title>About the Included CD</title>
-<?dbhtml filename="livecd.html"?>
-<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>
+<sect1 id="ch-intro-livecd">
+ <?dbhtml filename="livecd.html"?>
-<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>
+ <title>About the Included CD</title>
-<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>
+ <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>
- <listitem>
- <para>Text Editors</para>
- <itemizedlist>
- <listitem><para>Vim</para></listitem>
- <listitem><para>Nano</para></listitem>
- </itemizedlist>
- </listitem>
+ <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>
- <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>
+ <itemizedlist>
- <listitem>
- <para>Filesystem Programs</para>
- <itemizedlist>
- <listitem><para>Reiserfsprogs</para></listitem>
- <listitem><para>Xfsprogs</para></listitem>
- </itemizedlist>
- </listitem>
+ <listitem>
+ <para>An HTML version of this book</para>
+ </listitem>
- <listitem><para>nALFS - A tool for automating LFS builds</para></listitem>
-</itemizedlist>
+ <listitem>
+ <para>The X Window System Environment</para>
+ </listitem>
-</sect1>
+ <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/resources.xml b/chapter01/resources.xml
new file mode 100644
index 000000000..de67308ff
--- /dev/null
+++ b/chapter01/resources.xml
@@ -0,0 +1,91 @@
+<?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-intro-resources">
+ <?dbhtml filename="resources.html"?>
+
+ <title>Resources</title>
+
+ <sect2 id="ch-intro-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)
+ that is located at <ulink url="&faq-root;"/>.</para>
+
+ </sect2>
+
+ <sect2 id="ch-intro-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. If the FAQ does not solve
+ the problem you are having, the next step would be to search the mailing
+ lists at <ulink url="&lfs-root;search.html"/>.</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>
+
+ <!-- Remove until such time as we have our own News Server, JH 20060105
+ <sect2 id="ch-intro-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-intro-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>. The support channel is named
+ #LFS-support.</para>
+
+ </sect2>
+
+ <sect2 id="ch-intro-references">
+ <title>References</title>
+
+ <para>For additional information on the packages, useful tips are
+ available in the LFS Package Reference page located at <ulink
+ url="http://www.linuxfromscratch.org/~matthew/LFS-references.html"/>.</para>
+
+ </sect2>
+
+ <sect2 id="ch-intro-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;mirrors.html"/> for a list
+ of current mirrors.</para>
+
+ </sect2>
+
+ <sect2 id="ch-intro-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>