r5496 - in trunk/BOOK: book introduction introduction/important introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Wed Dec 28 17:24:56 PST 2005


Author: randy
Date: 2005-12-28 18:24:51 -0700 (Wed, 28 Dec 2005)
New Revision: 5496

Added:
   trunk/BOOK/introduction/important/important.xml
   trunk/BOOK/introduction/welcome/welcome.xml
Modified:
   trunk/BOOK/book/preface.xml
   trunk/BOOK/introduction/important/beyond.xml
   trunk/BOOK/introduction/important/patches.xml
   trunk/BOOK/introduction/important/pkgmgt.xml
   trunk/BOOK/introduction/important/position.xml
   trunk/BOOK/introduction/important/unpacking.xml
   trunk/BOOK/introduction/introduction.xml
   trunk/BOOK/introduction/welcome/acknowledgments.xml
   trunk/BOOK/introduction/welcome/askhelp.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/contact.xml
   trunk/BOOK/introduction/welcome/conventions.xml
   trunk/BOOK/introduction/welcome/credits.xml
   trunk/BOOK/introduction/welcome/maillists.xml
   trunk/BOOK/introduction/welcome/mirrors.xml
   trunk/BOOK/introduction/welcome/packages.xml
   trunk/BOOK/introduction/welcome/version.xml
   trunk/BOOK/introduction/welcome/which.xml
Log:
Changes to the Introduction section; standardized the file structure layout, standardized the id tags (except bootscripts) and some minor textual modifications

Modified: trunk/BOOK/book/preface.xml
===================================================================
--- trunk/BOOK/book/preface.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/book/preface.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -105,7 +105,7 @@
       of your system.</para>
 
       <para>Changes and upgrades to the individual packages are detailed in the
-      <xref linkend='intro-welcome-changelog'/>.  There you will see literally hundreds of
+      <xref linkend='changelog'/>.  There you will see literally hundreds of
       changes made since the last edition.  In this change log, one name that you
       will see over and over is Randy McMurchy.  Without his efforts this
       release would not have been possible.  I want to take this opportunity to thank
@@ -143,8 +143,8 @@
       continues the tradition of providing an extensive set of instructions for
       extending a basic Linux From Scratch system.    The instructions in this
       version of BLFS are based on the LFS 6.1 Book.  As usual, the list of
-      packages that have been upgraded or added are in the <xref
-      linkend='intro-welcome-changelog'/>.</para>
+      packages that have been upgraded or added are in the
+      <xref linkend='changelog'/>.</para>
 
       <para>One major accomplishment in this
       version of the book is the completion of the Index.  This section

Modified: trunk/BOOK/introduction/important/beyond.xml
===================================================================
--- trunk/BOOK/introduction/important/beyond.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/beyond.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-important-beyond">
+<sect1 id="beyond" xreflabel="Going Beyond BLFS">
   <?dbhtml filename="beyond.html"?>
 
   <sect1info>
@@ -41,24 +41,28 @@
     <listitem>
       <para>Add <filename class='directory'>$PREFIX/lib</filename>
       to <filename>/etc/ld.so.conf</filename> or expand
-      <envar>LD_LIBRARY_PATH</envar> to include it. Before using the latter option,
-      check out <ulink url="http://www.visi.com/~barr/ldpath.html"/>. If you
-      modify <filename>/etc/ld.so.conf</filename>, remember to update
-      <filename>/etc/ld.so.cache</filename> by executing <command>ldconfig</command>
-      as the <systemitem class="username">root</systemitem> user.</para>
+      <envar>LD_LIBRARY_PATH</envar> to include it. Before using the latter
+      option, check out <ulink url="http://www.visi.com/~barr/ldpath.html"/>.
+      If you modify <filename>/etc/ld.so.conf</filename>, remember to update
+      <filename>/etc/ld.so.cache</filename> by executing
+      <command>ldconfig</command> as the
+      <systemitem class="username">root</systemitem> user.</para>
     </listitem>
     <listitem>
       <para>Add <filename class='directory'>$PREFIX/man</filename>
-      to <filename>/etc/man.conf</filename> or expand <envar>MANPATH</envar>.</para>
+      to <filename>/etc/man.conf</filename> or expand
+      <envar>MANPATH</envar>.</para>
     </listitem>
     <listitem>
       <para>Add <filename class='directory'>$PREFIX/info</filename>
       to <envar>INFOPATH</envar>.</para>
     </listitem>
     <listitem>
-      <para>Add <filename
-      class='directory'>$PREFIX/lib/pkgconfig</filename> to
-      <envar>PKG_CONFIG_PATH</envar>.</para>
+      <para>Add <filename class='directory'>$PREFIX/lib/pkgconfig</filename>
+      to <envar>PKG_CONFIG_PATH</envar>. Some packages are now installing
+      <filename class='extension'>.pc</filename> files in
+      <filename class='directory'>$PREFIX/share/pkgconfig</filename>, so you may
+      have to include this directory also.</para>
     </listitem>
     <listitem>
       <para>Add <filename class='directory'>$PREFIX/include</filename> to
@@ -68,23 +72,25 @@
   </itemizedlist>
 
   <para>If you are in search of a package that is not in the book, the following
-  are different ways you can search for the concerned package.</para>
+  are different ways you can search for the desired package.</para>
 
   <itemizedlist>
     <listitem>
       <para>If you know the name of the package, then search FreshMeat for
       it at <ulink url="http://freshmeat.net/"/>. Also search Google at
-      <ulink url="http://google.com/"/>. Sometimes a search for the rpm at
-      <ulink url="http://rpmfind.net/"/> or the deb at
-      <ulink url="http://www.debian.org/distrib/packages#search_packages"/> can also
-      lead to a link to the package.</para>
+      <ulink url="http://google.com/"/>. Sometimes a search for the
+      <filename class='extension'>rpm</filename> at
+      <ulink url="http://rpmfind.net/"/> or the
+      <filename class='extension'>deb</filename> at
+      <ulink url="http://www.debian.org/distrib/packages#search_packages"/> can
+      also lead to a link to the package.</para>
     </listitem>
     <listitem>
       <para>If you know the name of the executable, but not the package
-      that the executable belongs to, first try a google search with the name of the
-      executable. If the results are overwhelming, try searching for the given
-      executable in the Debian repository at
-      <ulink url="http://www.debian.org/distrib/packages#search_contents"/>.</para>
+      that the executable belongs to, first try a Google search with the name
+      of the executable. If the results are overwhelming, try searching for the
+      given executable in the Debian repository at <ulink
+      url="http://www.debian.org/distrib/packages#search_contents"/>.</para>
     </listitem>
   </itemizedlist>
 
@@ -100,19 +106,22 @@
     <listitem>
       <para>Most of the packages contain documentation on compiling and
       installing the package. Some of the documents are excellent, some not so
-      excellent. Check out the homepage of the package for any additional and updated
-      hints for compiling and configuring the package.</para>
+      excellent. Check out the homepage of the package for any additional and
+      updated hints for compiling and configuring the package.</para>
     </listitem>
     <listitem>
       <para>If you are having a problem compiling the package, try
-      searching the lfs archives at <ulink url="http://search.linuxfromscratch.org/"/>
-      for the error or if that fails try searching Google. If everything else fails,
-      try the blfs-support mailing-list/news-group.</para>
+      searching the LFS archives at
+      <ulink url="http://search.linuxfromscratch.org/"/> for the error or if
+      that fails, try searching Google. If everything else fails,
+      try the blfs-support mailing-list.</para>
     </listitem>
   </itemizedlist>
 
   <tip>
-    <para>If you have found a package that is only available in .deb or .rpm
+    <para>If you have found a package that is only available in
+    <filename class='extension'>.deb</filename> or
+    <filename class='extension'>.rpm</filename>
     format, there are two small scripts, <command>rpm2targz</command> and
     <command>deb2targz</command> that are available at
     <ulink url="&downloads-project;/deb2targz.tar.bz2"/> and

Added: trunk/BOOK/introduction/important/important.xml
===================================================================
--- trunk/BOOK/introduction/important/important.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/important.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -0,0 +1,25 @@
+<?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="important">
+  <?dbhtml filename="important.html"?>
+
+  <title>Important Information</title>
+
+  <para>This chapter is used to explain some of the policies used throughout
+  the book, to introduce important concepts and to explain some issues you may
+  see with some of the included packages.</para>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pkgmgt.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="unpacking.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="position.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="patches.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bootscripts.xml"/>
+  <!--  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="locale-issues.xml"/> -->
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="beyond.xml"/>
+
+</chapter>


Property changes on: trunk/BOOK/introduction/important/important.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/introduction/important/patches.xml
===================================================================
--- trunk/BOOK/introduction/important/patches.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/patches.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-important-patches">
+<sect1 id="patches">
   <?dbhtml filename="patches.html"?>
 
   <sect1info>

Modified: trunk/BOOK/introduction/important/pkgmgt.xml
===================================================================
--- trunk/BOOK/introduction/important/pkgmgt.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/pkgmgt.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-important-pkgmgt">
+<sect1 id="pkgmgt">
   <?dbhtml filename="pkgmgt.html"?>
 
   <sect1info>
@@ -42,7 +42,7 @@
 
   <para>There are some hints written on the topic of package management. Visit
   the <ulink url="&hints-root;">Hints subproject</ulink>
-  to find if one of them fits your need.</para>
+  and see if one of them fits your need.</para>
 
   <sect2>
     <title>Upgrade Issues</title>
@@ -85,8 +85,8 @@
       <listitem>
         <para>If you are upgrading a running system, be on the lookout for packages
         that use <command>cp</command> instead of <command>install</command>
-        to install files. The latter command is usually safer if the executable or library
-        is already loaded in memory.</para>
+        to install files. The latter command is usually safer if the executable
+        or library is already loaded in memory.</para>
       </listitem>
     </itemizedlist>
 
@@ -113,9 +113,9 @@
     <sect3>
       <title>Install in Separate Directories</title>
 
-      <para>This is a simplistic package management that does not need any extra package
-      to manage the installations. Each package is installed in a separate directory.
-      For example, package foo-1.1 is installed in
+      <para>This is a simplistic package management that does not need any
+      extra package to manage the installations. Each package is installed in a
+      separate directory. For example, package foo-1.1 is installed in
       <filename class='directory'>/usr/pkg/foo-1.1</filename>
       and a symlink is made from <filename>/usr/pkg/foo</filename> to
       <filename class='directory'>/usr/pkg/foo-1.1</filename>. When installing
@@ -124,7 +124,7 @@
       symlink is replaced by a symlink to the new version.</para>
 
       <para>The environment variables such as those mentioned in
-      <xref linkend="intro-important-beyond"/> need to be expanded to
+      <quote><xref linkend="beyond"/></quote> need to be expanded to
       include <filename>/usr/pkg/foo</filename>. For more than a few packages,
       this scheme becomes unmanageable.</para>
 

Modified: trunk/BOOK/introduction/important/position.xml
===================================================================
--- trunk/BOOK/introduction/important/position.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/position.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-important-position">
+<sect1 id="position">
   <?dbhtml filename="position.html"?>
 
   <sect1info>
@@ -21,67 +21,76 @@
   <para>This is a question without an obvious answer for an
   LFS based system.</para>
 
-  <para>In traditional Unix systems, <filename>/usr</filename> usually
-  contains files that come with the system distribution, and the <filename>
-  /usr/local</filename> tree is free for the local administrator to manage.
-  The only really hard and fast rule is that Unix distributions should not
-  touch <filename>/usr/local</filename>, except perhaps to create the basic
-  directories within it.</para>
+  <para>In traditional Unix systems,
+  <filename class='directory'>/usr</filename> usually contains files that come
+  with the system distribution, and the
+  <filename class='directory'>/usr/local</filename> tree is free for the local
+  administrator to manage. The only really hard and fast rule is that Unix
+  distributions should not touch
+  <filename class='directory'>/usr/local</filename>, except perhaps to create
+  the basic directories within it.</para>
 
-  <para>With Linux distributions, like Red Hat, Debian etc. a possible rule is
-  that <filename>/usr</filename> is managed by the distribution's
-  package system and <filename>/usr/local</filename> is not.  This way the
+  <para>With Linux distributions like Red Hat, Debian, etc., a possible rule is
+  that <filename class='directory'>/usr</filename> is managed by the
+  distribution's package system and
+  <filename class='directory'>/usr/local</filename> is not. This way the
   package manager's database knows about every file within
-  <filename>/usr</filename>.</para>
+  <filename class='directory'>/usr</filename>.</para>
 
   <para>LFS users build their own system and so deciding where
   the system ends and local files begin is not straightforward.  So the choice
-  should be made in order to make things easier to administer.  There are several
-  reasons for dividing files between <filename>/usr</filename> and
-  <filename>/usr/local</filename>.</para>
+  should be made in order to make things easier to administer.  There are
+  several reasons for dividing files between
+  <filename class='directory'>/usr</filename> and
+  <filename class='directory'>/usr/local</filename>.</para>
 
   <itemizedlist>
     <listitem>
-      <para>On a network of several machines all running LFS,
-      or mixed LFS and other Linux distributions,
-      <filename>/usr/local</filename> could be used to hold packages
-      that are common between all the computers in the network.  It can be
-      NFS mounted or mirrored from a single server.  Here local
-      indicates local to the site.</para>
+      <para>On a network of several machines all running LFS, or mixed LFS and
+      other Linux distributions,
+      <filename class='directory'>/usr/local</filename> could be used to hold
+      packages that are common between all the computers in the network. It can
+      be NFS mounted or mirrored from a single server. Here local indicates
+      local to the site.</para>
     </listitem>
     <listitem>
       <para>On a network of several computers all running an identical
-      LFS system <filename>/usr/local</filename> could hold
-      packages that are different between the machines.  In this case local refers
-      to the individual computers.</para>
+      LFS system, <filename class='directory'>/usr/local</filename> could hold
+      packages that are different between the machines. In this case local
+      refers to the individual computers.</para>
     </listitem>
     <listitem>
-      <para>Even on a single computer <filename>/usr/local</filename> can
-      be useful if you have several distributions installed simultaneously, and want
+      <para>Even on a single computer,
+      <filename class='directory'>/usr/local</filename> can be useful if you
+      have several distributions installed simultaneously, and want
       a place to put packages that will be the same on all of them.</para>
     </listitem>
     <listitem>
       <para>Or you might regularly rebuild your LFS, but
-      want a place to put files that you don't want to rebuild each time.  This way
-      you can wipe the LFS file system and start from a clean
+      want a place to put files that you don't want to rebuild each time.  This
+      way you can wipe the LFS file system and start from a clean
       partition every time without losing everything.</para>
     </listitem>
   </itemizedlist>
 
-  <para>Some people ask why not use your own directory tree, e.g., <filename>
-  /usr/site</filename>, rather than <filename>/usr/local</filename>?</para>
+  <para>Some people ask why not use your own directory tree, e.g.,
+  <filename class='directory'>/usr/site</filename>, rather than
+  <filename class='directory'>/usr/local</filename>?</para>
 
   <para>There is nothing stopping you, many sites do make their own trees,
   however it makes installing new software more difficult.  Automatic installers
-  often look for dependencies in <filename>/usr</filename> and
-  <filename>/usr/local</filename>, and if the file it is looking
-  for is in <filename>/usr/site</filename> instead, the installer will
-  probably fail unless you specifically tell it where to look.</para>
+  often look for dependencies in
+  <filename class='directory'>/usr</filename> and
+  <filename class='directory'>/usr/local</filename>, and if the file it is
+  looking for is in <filename class='directory'>/usr/site</filename> instead,
+  the installer will probably fail unless you specifically tell it where to
+  look.</para>
 
   <para><emphasis>What is the BLFS position on this?</emphasis></para>
 
   <para>All of the BLFS instructions install programs in
-  <filename>/usr</filename> with optional instructions to install into
-  <filename>/opt</filename> for some specific packages.</para>
+  <filename class='directory'>/usr</filename> with optional instructions to
+  install into <filename class='directory'>/opt</filename> for some specific
+  packages.</para>
 
 </sect1>

Modified: trunk/BOOK/introduction/important/unpacking.xml
===================================================================
--- trunk/BOOK/introduction/important/unpacking.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/important/unpacking.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-important-unpacking">
+<sect1 id="unpacking">
   <?dbhtml filename="unpacking.html"?>
 
   <sect1info>
@@ -15,7 +15,7 @@
 
   <title>Notes on Building Software</title>
 
-  <para>Those people who have built an LFS system will be aware
+  <para>Those people who have built an LFS system may be aware
   of the general principles of downloading and unpacking software.  We will
   however repeat some of that information here for those new to building
   their own software.</para>
@@ -33,7 +33,8 @@
 
   <para>We can not emphasize strongly enough that you should start from a
   <emphasis>clean source tree</emphasis> each time. This means that if
-  you have had an error, it's usually best to delete the source tree and
+  you have had an error during configuration or compilation, it's usually
+  best to delete the source tree and
   re-unpack it <emphasis>before</emphasis> trying again. This obviously
   doesn't apply if you're an advanced user used to hacking
   <filename>Makefile</filename>s and C code, but if in doubt, start from a
@@ -142,19 +143,20 @@
 
     <itemizedlist>
       <listitem>
-        <para><emphasis>Required</emphasis> means
-            that the target package cannot be correctly built without
-            the dependency having first been installed.</para>
+        <para><emphasis>Required</emphasis> means that the target package
+        cannot be correctly built without the dependency having first been
+        installed.</para>
       </listitem>
       <listitem>
-        <para><emphasis>Recommended</emphasis> means that BLFS strongly suggests this package is
-           installed first for a clean and trouble-free build, that won't have
-           issues either during the build process, or at run-time.</para>
+        <para><emphasis>Recommended</emphasis> means that BLFS strongly
+        suggests this package is installed first for a clean and trouble-free
+        build, that won't have issues either during the build process, or at
+        run-time.</para>
       </listitem>
       <listitem>
-        <para><emphasis>Optional</emphasis> means that this package might be installed for added
-           functionality.  Often BLFS will qualify the dependency to explain the
-           added functionality that will result.</para>
+        <para><emphasis>Optional</emphasis> means that this package might be
+        installed for added functionality. Often BLFS will describe the
+        dependency to explain the added functionality that will result.</para>
       </listitem>
     </itemizedlist>
 

Modified: trunk/BOOK/introduction/introduction.xml
===================================================================
--- trunk/BOOK/introduction/introduction.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/introduction.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -10,48 +10,7 @@
 
   <title>Introduction</title>
 
-  <chapter id="intro-welcome">
-    <?dbhtml filename="welcome.html"?>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/welcome.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/important.xml"/>
 
-    <title>Welcome to BLFS</title>
-
-    <para>The Beyond Linux From Scratch book is designed to carry on from
-    where the LFS book leaves off.  But unlike the LFS book, it isn't designed to
-    be followed straight through.  Reading the <xref
-    linkend="intro-welcome-whichsections"/> part of this chapter should help
-    guide you through the book.</para>
-
-    <para>Please read most of this part of the book carefully as it explains
-    quite a few of the conventions we use throughout the book.</para>
-
-
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/acknowledgments.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/credits.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/which.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/conventions.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/version.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/mirrors.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/packages.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/changelog.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/maillists.xml"/>
- <!--   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/newsserver.xml"/> -->
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/askhelp.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="welcome/contact.xml"/>
-
-  </chapter>
-
-  <chapter id="intro-important">
-    <?dbhtml filename="important.html"?>
-
-    <title>Important Information</title>
-
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/pkgmgt.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/unpacking.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/position.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/patches.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/bootscripts.xml"/>
-    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="important/beyond.xml"/>
-
-  </chapter>
-
 </part>

Modified: trunk/BOOK/introduction/welcome/acknowledgments.xml
===================================================================
--- trunk/BOOK/introduction/welcome/acknowledgments.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/acknowledgments.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-acknowledgments">
+<sect1 id="acknowledgments">
   <?dbhtml filename="acknowledgments.html"?>
 
   <sect1info>
@@ -70,4 +70,3 @@
   </itemizedlist>
 
 </sect1>
-

Modified: trunk/BOOK/introduction/welcome/askhelp.xml
===================================================================
--- trunk/BOOK/introduction/welcome/askhelp.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/askhelp.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-askhelp">
+<sect1 id="askhelp">
   <?dbhtml filename="askhelp.html"?>
 
   <sect1info>
@@ -19,7 +19,7 @@
   is not listed in the FAQ (<ulink url="http://www.linuxfromscratch.org/faq"/>),
   you will find that most of the people on Internet Relay Chat (IRC) and on the
   mailing lists are willing to help you. An overview of the LFS mailing
-  lists can be found in <xref linkend="intro-welcome-maillists"/>. To assist us
+  lists can be found in <xref linkend="maillists"/>. To assist us
   in diagnosing and solving your problem, include as much relevant information
   as possible in your request for help.</para>
 
@@ -35,7 +35,7 @@
         configured properly in <filename>modules.conf</filename> and has it
         been loaded?  You should use <command>lsmod</command> as the
         <systemitem class='username'>root</systemitem> user to see if it's
-        loaded. Check the <filename>syslog.log</filename> or run
+        loaded. Check the <filename>syslog.log</filename> file or run
         <command>modprobe <replaceable>[driver]</replaceable></command> to
         review any error message. If it loads properly, you may need to add
         the <command>modprobe</command> command to your boot scripts.</para>
@@ -56,7 +56,7 @@
         environment variables for each package placed there (e.g.,
         PATH=$PATH:/opt/kde/bin). In most cases, the package instructions will
         walk you through the changes, but some will not. The section called
-        <quote><ulink url="beyond.html">Going Beyond BLFS</ulink></quote> is
+        <quote><xref linkend="beyond"/></quote> is
         available to help you check.</para>
       </listitem>
     </itemizedlist>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-changelog" xreflabel='Change Log'>
+<sect1 id="changelog" xreflabel='Change Log'>
   <?dbhtml filename="changelog.html"?>
 
   <sect1info>
@@ -17,7 +17,7 @@
 
   <para>Please note that the Change Log only lists which editor was
   responsible for putting the changes into SVN; please read the
-  <xref linkend="intro-welcome-credits"/> page in Chapter 1 for details on
+  <xref linkend="credits"/> page in Chapter 1 for details on
   who wrote what.</para>
 
   <para>Current release: &version; – &releasedate;</para>

Modified: trunk/BOOK/introduction/welcome/contact.xml
===================================================================
--- trunk/BOOK/introduction/welcome/contact.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/contact.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-contactinfo">
+<sect1 id="contactinfo">
   <?dbhtml filename="contactinfo.html"?>
 
   <sect1info>
@@ -16,7 +16,7 @@
   <title>Contact Information</title>
 
   <para>Please direct your emails to one of the BLFS mailing lists. See
-  <xref linkend="intro-welcome-maillists"/> for more information on
+  <xref linkend="maillists"/> for more information on
   the available mailing lists.</para>
 
   <para>The current BLFS maintainer is &maintainer-fullname;.
@@ -24,4 +24,3 @@
   <ulink url="mailto:&maintainer-address;">&maintainer-address;</ulink>.</para>
 
 </sect1>
-

Modified: trunk/BOOK/introduction/welcome/conventions.xml
===================================================================
--- trunk/BOOK/introduction/welcome/conventions.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/conventions.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-conventions">
+<sect1 id="conventions">
   <?dbhtml filename="conventions.html"?>
 
   <sect1info>
@@ -31,7 +31,7 @@
 
   <blockquote>
     <para>This form of text (fixed width text) is showing screen
-    output, probably as the result of commands issued and is also used to
+    output, probably a result from issuing a command. It is also used to
     show filenames such as <filename>/boot/grub/grub.conf</filename></para>
   </blockquote>
 
@@ -47,7 +47,7 @@
 
   <blockquote>
     <para>This form of text is used for hypertext links external to
-    the book such as HowTo's, download locations, websites, etc.</para>
+    the book such as HowTos, download locations, websites, etc.</para>
   </blockquote>
 
   <para><xref linkend="mozilla"/></para>
@@ -83,8 +83,8 @@
   <para><systemitem class='username'>root</systemitem></para>
 
   <blockquote>
-    <para>This form of text is used to show a specific system user reference
-    in the instructions.</para>
+    <para>This form of text is used to show a specific system user or group
+    reference in the instructions.</para>
   </blockquote>
 
 </sect1>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/credits.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-credits" xreflabel="Credits">
+<sect1 id="credits" xreflabel="Credits">
   <?dbhtml filename="credits.html"?>
 
   <sect1info>

Modified: trunk/BOOK/introduction/welcome/maillists.xml
===================================================================
--- trunk/BOOK/introduction/welcome/maillists.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/maillists.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-maillists" xreflabel="Mailing lists">
+<sect1 id="maillists" xreflabel="Mailing lists">
   <?dbhtml filename="maillists.html"?>
 
   <sect1info>
@@ -20,7 +20,7 @@
   among others, the main development and support lists.</para>
 
   <para>For more information regarding which lists are available, how to
-  subscribe to them, archive locations, etc. visit <ulink
-  url="http://www.linuxfromscratch.org/mail.html"/>.</para>
+  subscribe to them, archive locations, etc., visit
+  <ulink url="http://www.linuxfromscratch.org/mail.html"/>.</para>
 
 </sect1>

Modified: trunk/BOOK/introduction/welcome/mirrors.xml
===================================================================
--- trunk/BOOK/introduction/welcome/mirrors.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/mirrors.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-mirrors" xreflabel="Mirrors">
+<sect1 id="mirrors" xreflabel="Mirrors">
   <?dbhtml filename="mirrors.html"?>
 
   <sect1info>
@@ -15,11 +15,9 @@
 
   <title>Mirror Sites</title>
 
-  <para>The BLFS project has a number of mirrors setup world-wide to make it
-  easier and more convenient for you to access the website.  Please visit the
+  <para>The BLFS project has a number of mirrors set up world-wide to make it
+  easier and more convenient for you to access the website. Please visit the
   <ulink url="http://www.linuxfromscratch.org/mirrors.html"/> website for the
   list of current mirrors.</para>
 
 </sect1>
-
-

Modified: trunk/BOOK/introduction/welcome/packages.xml
===================================================================
--- trunk/BOOK/introduction/welcome/packages.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/packages.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-packages" xreflabel="Getting the Source Packages">
+<sect1 id="packages" xreflabel="Getting the Source Packages">
   <?dbhtml filename="packages.html"?>
 
   <sect1info>

Modified: trunk/BOOK/introduction/welcome/version.xml
===================================================================
--- trunk/BOOK/introduction/welcome/version.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/version.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-version" xreflabel="Book Version">
+<sect1 id="version" xreflabel="Book Version">
   <?dbhtml filename="version.html"?>
 
   <sect1info>
@@ -17,8 +17,8 @@
 
   <para>This is BLFS-BOOK version &version; dated &releasedate;.
   If this version is older than a month, a newer version is probably already
-  available for download. Check one of the mirror sites below for updated
+  available for download. Check one of the mirror sites at
+  <ulink url="http://www.linuxfromscratch.org/mirrors.html"/> for updated
   versions.</para>
 
 </sect1>
-

Added: trunk/BOOK/introduction/welcome/welcome.xml
===================================================================
--- trunk/BOOK/introduction/welcome/welcome.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/welcome.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -0,0 +1,34 @@
+<?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="welcome">
+  <?dbhtml filename="welcome.html"?>
+
+  <title>Welcome to BLFS</title>
+
+  <para>The Beyond Linux From Scratch book is designed to carry on from where
+  the LFS book leaves off. But unlike the LFS book, it isn't designed to be
+  followed straight through.  Reading the <xref linkend="whichsections"/>
+  part of this chapter should help guide you through the book.</para>
+
+  <para>Please read most of this part of the book carefully as it explains
+  quite a few of the conventions used throughout the book.</para>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="acknowledgments.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="credits.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="which.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="conventions.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="version.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mirrors.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="packages.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="maillists.xml"/>
+  <!--   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="newsserver.xml"/> -->
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askhelp.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="contact.xml"/>
+
+</chapter>


Property changes on: trunk/BOOK/introduction/welcome/welcome.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/introduction/welcome/which.xml
===================================================================
--- trunk/BOOK/introduction/welcome/which.xml	2005-12-28 21:40:28 UTC (rev 5495)
+++ trunk/BOOK/introduction/welcome/which.xml	2005-12-29 01:24:51 UTC (rev 5496)
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="intro-welcome-whichsections" xreflabel="Which sections of the book?">
+<sect1 id="whichsections" xreflabel="Which sections of the book?">
   <?dbhtml filename="which.html"?>
 
   <sect1info>
@@ -16,18 +16,18 @@
   <title>Which Sections of the Book Do I Want?</title>
 
   <para>Unlike the Linux From Scratch book, BLFS isn't designed to be
-  followed in a linear manner.  This is because LFS  provides instructions
+  followed in a linear manner. This is because LFS provides instructions
   on how to create a base system which is capable of turning into anything
-  from a web server to a multimedia desktop system.  BLFS is where we try
+  from a web server to a multimedia desktop system. BLFS is where we try
   to guide you in the process of going from the base system to your intended
   destination. Choice is very much involved.</para>
 
   <para>Everyone who reads the book will want to read certain sections.  The
-  <xref linkend="introduction"/> part–which you are currently
-  reading–contains generic information.  Especially take note of the
-  information in Important Information (<xref linkend="intro-important"/>), as
-  this contains comments about how to unpack software and various other aspects
-  which apply throughout the book.</para>
+  <xref linkend="introduction"/> part, which you are currently reading,
+  contains generic information.  Especially take note of the information in
+  <xref linkend="important"/>, as this contains comments about how to
+  unpack software, issues related to using different locales and various other
+  aspects which apply throughout the book.</para>
 
   <para>The part on <xref linkend="postlfs"/> is where most people will want
   to turn next.  This deals with not just configuration but also Security
@@ -38,13 +38,13 @@
   the sections on Editors and File Systems) while building your LFS
   system.</para>
 
-<para>Following these basic items, most people will want to at least browse
+  <para>Following these basic items, most people will want to at least browse
   through the <xref linkend="general"/> part of the book.  This part contains
   information on many items which are prerequisites for other sections of the
-  book as well as some items (such as Programming (<xref linkend="general-prog"/>)
+  book as well as some items (such as <xref linkend="general-prog"/>)
   which are useful in their own right.  Note that you don't have to install all
   of these libraries and packages found in this part to start with, each
-  BLFS install procedure tells you which packages
+  BLFS installation procedure tells you which packages
   it depends upon so you can choose the program you want to install and see
   what it needs.</para>
 
@@ -60,11 +60,11 @@
   <para>Once you have dealt with these basics, you may wish to configure
   more advanced network services.  These are dealt with in the <xref
   linkend="server"/> part of the book.  Those wanting to build servers
-  should find  a good starting point there.  Note that <xref linkend="server"/>
+  should find a good starting point there.  Note that this section
   also contains information on various database packages.</para>
 
   <para>The next parts of the book principally deal with desktop systems.  This
-  portion of the book starts with a part talking about <xref linkend="x"/>.  This
+  portion of the book starts with a part talking about <xref linkend="x"/>. This
   part also deals with some generic X-based libraries (<xref linkend="x-lib"/>).
   After this, <xref linkend="kde"/> and <xref linkend="gnome"/> are given their
   own parts which are followed by one on <xref linkend="xsoft"/>.</para>
@@ -82,4 +82,3 @@
   <para>We hope you enjoy using BLFS and find it useful.</para>
 
 </sect1>
-




More information about the blfs-book mailing list