applied Scot's LFS-BOOK-CVS-20020530-XML.patch

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

chapter01/alfsdiscuss.xml

@@ -1,11 +1,10 @@
 <sect2>
 <title>alfs-discuss</title>
 
-<para>The alfs-discuss list discusses the development of ALFS, which stands for
+<para>The alfs-discuss list discusses the development of ALFS, which is short
-Automated Linux From Scratch. The goal of this project is to develop an
+for Automated Linux From Scratch. The goal of this project is to develop an
-installation tool that can install an LFS system automatically.
+installation tool that installs an LFS system automatically, thus speeding
-Its main goal is to speed up compilation by taking away the need to
+up compilation by taking away the need to manually enter the commands.</para>
-manually enter the commands to configure, compile, and install packages.</para>
 
 </sect2>
 

chapter01/blfsbook.xml

@@ -1,9 +1,9 @@
 <sect2>
 <title>blfs-book</title>
 
-<para>The blfs-book list is used by the BLFS-BOOK editors 
+<para>The blfs-book list is used by the BLFS-BOOK editors to co-ordinate
-to co-ordinate blfs-book's maintenance, like XML issues and the like. 
+the maintenance of the BLFS book, such as XML source code issues and the
-Actual discussion on what should be added and removed should take place 
+like. Actual discussion on what should be added and removed should take place 
 on blfs-dev.</para>
 
 </sect2>

chapter01/blfsdev.xml

@@ -1,15 +1,12 @@
 <sect2>
 <title>blfs-dev</title>
 
-<para>The blfs-dev mailing list discusses matters related to the
+<para>The blfs-dev mailing list discusses development of the
-BLFS-BOOK (Beyond LFS).  If problems with the book come up, a bug 
+BLFS-BOOK (Beyond LFS). This is the maillist to submit bug reports,
-or two need to be
+and make suggestions to improve the BLFS book.</para>
-reported, or suggestions to improve the book (such as suggestions as to
-installation instructions to add) are to be made, this mailing list 
-is the right one.</para>
 
-<para>Requests for help with programs beyond the base LFS setup (not
+<para>Requests for help with programs beyond the base LFS build and setup
-just those in BLFS) should go to blfs-support.</para>
+(not just those in the BLFS book) should be made in blfs-support.</para>
 
 </sect2>
 

chapter01/blfssupport.xml

@@ -1,9 +1,8 @@
 <sect2>
 <title>blfs-support</title>
 
-<para>The blfs-support list deals with support requests for any software
+<para>The blfs-support list handles support requests for any software
-not installed in the LFS book.  The list is not just for help with
+that is not built or installed in the LFS book.  Any software beyond what is
-software explicitly mentioned in the BLFS book, any software beyond that
 installed as part of the base LFS system can be discussed here.</para>
 
 </sect2>

chapter01/faq.xml

@@ -2,7 +2,7 @@
 <title>FAQ</title>
 <?dbhtml filename="faq.html" dir="chapter01"?>
 
-<para>If you encounter any problems building an LFS system, you should
+<para>If you encounter any problems while building an LFS system, you should
 check out <ulink url="http://www.linuxfromscratch.org/faq/"/> to see if 
 your question is already answered in the FAQ.</para>
 

chapter01/how.xml

@@ -2,47 +2,65 @@
 <title>How things are going to be done</title>
 <?dbhtml filename="how.html" dir="chapter01"?>
 
-<para>We are going to build the LFS system by using an already installed Linux
+<para>We are going to build the LFS system by using a previously installed
-distribution such as Debian, SuSe, Slackware, Mandrake, RedHat, etc. There
+Linux distribution such as Debian, SuSe, Slackware, Mandrake, RedHat, etc.
-is no need to have any kind of bootdisk. We will use an existing Linux
+We will use the existing Linux system as the development platform, because
-system as the base (since we need a compiler, linker, text editor, and
+we need tools like a compiler, linker, text editor, and other necessary
-other tools).</para>
+development tools to build our system. Ordinarily, the required tools are
+available by default if we selected "development" as one of our installation
+options when we installed the distributed Linux.</para>
 
 <para>After you have downloaded the necessary packages that make up an LFS
-system you will create a new Linux native partition onto which the LFS system
+system we will create a new Linux native partition and filesystem. Here
-will be installed.</para>
+is where the LFS system will be compiled and installed.</para>
 
-<para>The next step, chapter 5, will be the installation of a number of
+<para>The next step, chapter 5, will discuss the installation of a number of
-packages that are statically linked and installed on the LFS partition.
+packages that will form a basic development suite that is used to
-These packages form a basic development suite which will be used to
+build the actual system, or needed to resolve circular dependencies. For
-install the actual system, and are also needed to resolve circular
+example, you need a compiler to build a new compiler, and you need a shell
-dependencies. Examples of circular dependencies are: you need a compiler 
+in order to install a new shell. The packages in this chapter will be linked
-to install a compiler. You need a shell in order to install a shell. And
+statically. Static linking describes a method of compiling software so that
-so on.</para>
+it does not require the presence of libraries when building is complete.
+The resulting program is able to function on its own. The program is able to
+do so because the pieces of the program that would normally remain in the
+libraries are copied from the libraries and built right into the program.
+Ordinarily software is built with dynamic linking. This conserves storage
+space and increases the efficiency of many programs. We statically link
+our software in chapter 5 because we will in theory be moving our
+development system to a virtual environment where the already mentioned
+libraries will be absent. If the software is built dynamically, our
+development suite will not function. Since the libraries we are talking
+about are provided by our distribution Linux, the goal of chapter 5 is to
+build a development environment where those libraries are not required
+and is therefore independent of the distribution.</para>
 
-<para>Chapter 6 installs the actual base system. We use the chroot program 
+<para>In chapter 6 we will build and install our final system. We will use
-to start a new shell whose root directory will be set to the LFS
+the chroot program to enter a virtual environment and start a new shell
-partition. This, in essence, is the same as rebooting and having the
+whose root directory will be set to the partition where we built all the
-kernel mount the LFS partition as the root partition. The reason that
+chapter 5 software. This is very similar to rebooting and instructing the
-we don't actually reboot, but instead chroot, is that this way you can
+kernel to mount our LFS partition as the root partition. The reason that
-still use your host system. While software is being installed you can
+we don't actually reboot, but instead chroot, is that creating a static
-simply switch to a different VC (Virtual Console) or X desktop and
+system that we can boot into requires more work that simply isn't necessary.
-continue using your computer as you normally would.</para>
+As well, we can continue to use our platform system while we are building
+LFS. While software is being compiled and installed you can simply switch
+to a different VC (Virtual Console) or X desktop and continue using your
+computer normally.</para>
 
-<para>When all the software is installed, chapter 7 will set up the boot
+<para>When all the software from chapter 6 is installed, chapters 7,8 and 9
-scripts. Chapter 8 will set up the Linux boot loader and in chapter 9
+will help us finalize our installation. We will set up our boot
-there are some pointers what you can do after you finish the book. Then
+scripts in chapter 7. In chapter 8 we will build our final linux kernel and
-you can finally reboot your system into your new LFS system, and start
+set up the Linux boot loader. Chapter 9 has some pointers to help you after
-to really use it.</para>
+you finish the book. Then finally, you reboot your system and boot into your
+new LFS system, and start to really use it.</para>
 
 <para>This is the process in a nutshell. Detailed information on the steps
-you are taking are provided in the chapters as you go through them. If
+we will take are discussed in the chapters and package descriptions as you
-something isn't completely clear yet, don't worry. It will become very
+progress through them. If something isn't completely clear now, don't worry.
-clear shortly.</para>
+It should become very clear shortly.</para>
 
 <para>Please read chapter 2 carefully as it explains a few important things
-you need to be aware of before you work your way through chapters 5 and
+you should be aware of before you begin to work through chapters 5 and
-above.</para>
+later.</para>
 
 </sect1>
 

preface/foreword.xml

@@ -2,15 +2,15 @@
 <title>Foreword</title>
 <?dbhtml filename="foreword.html" dir="preface"?>
 
-<para>Having used a number of different Linux distributions, I was never fully
+<para>Having used a number of different Linux distributions, I was never
-satisfied with any of them. I didn't like the way the arrangement of the
+fully satisfied with any of them. I didn't like the way the arrangement of
-bootscripts. I didn't like the way certain programs were configured by
+the bootscripts. I didn't like the way certain programs were configured by
-default. Much more of that sort of thing bothered me. Finally I realized that
+default. Much more of that sort of thing bothered me. Finally I realized
-if I wanted full satisfisfaction from my Linux system I would have to build
+that if I wanted full satisfisfaction from my Linux system I would have to
-my own system from scratch, using only the source code. I resolved not to use 
+build my own system from scratch, using only the source code. I resolved
-pre-compiled packages of any kind, nor CD-ROM or 
+not to use pre-compiled packages of any kind, nor CD-ROM or bootdisk that
-bootdisk that would install some basic utilities. I would use my current 
+would install some basic utilities. I would use my current Linux system to
-Linux system to develop my own.</para>
+develop my own.</para>
 
 <para>This wild idea seemed very difficult at the time and often seemed
 an impossible task. After sorting out all kinds of problems, such as

preface/organpart1.xml

@@ -1,10 +1,11 @@
 <sect2 id="pre-organ1">
 <title>Part I - Introduction</title>
 
-<para>Part One gives general information about this book (versions, where
+<para>Part I gives general information about the contents of book
-to get it, changelog, mailing lists, and how to get in touch with us).
+(revisions, where to get it, changelog, mailing lists, and other contact
-It also explains a few important aspects you really want and need to
+information). It also contains suggested reading that discusses a few
-read before starting to build an LFS system.</para>
+important considerations to think about before beginning your LFS
+system.</para>
 
 </sect2>
 

preface/organpart2.xml

@@ -1,10 +1,11 @@
 <sect2 id="pre-organ2">
-<title>Part II - Installation of the LFS system</title>
+<title>Part II - Installation of the base LFS system</title>
 
-<para>Part Two guides you through the installation of the LFS system which will 
+<para>Part II guides you through the building and installation of an LFS
-be the foundation for the rest of the system. Whatever you choose to do 
+system. The finished LFS system will be the core foundation that the rest
-with your brand new LFS system, it will be built on the foundation 
+of your Linux system will be built on. What you choose to do with your brand
-that's installed in this part.</para>
+new LFS system will be built and supported by this foundation that we build
+in Part II.</para>
 
 </sect2>
 

preface/organpart3.xml

@@ -1,7 +1,7 @@
 <sect2 id="pre-organ3">
 <title>Part III - Appendixes</title>
 
-<para>Part Three contains various Appendices.</para>
+<para>Part III contains various Appendices.</para>
 
 </sect2>
 

preface/whoread.xml

@@ -3,13 +3,13 @@
 <?dbhtml filename="whoread.html" dir="preface"?>
 
 <para>There are many reasons why somebody would want to read this book. The
-principle reason being to install a LFS system. A question many people raise 
+principle reason being to install an LFS system. A question many people raise 
 is "Why go through all the hassle of manually building a Linux system 
-from scratch when you can just download and install an  existing one?". That
+from scratch when you can just download and install an existing one?". That
 is a good question.</para>
 
 <para>One important reason for LFS's existence is helping people 
-learn how a Linux system works from the inside out. Building a LFS system
+learn how a Linux system works from the inside out. Building an LFS system
 helps demonstrate what makes Linux tick, and how things work together and
 depend on each other. And perhaps most importantly, how to customize it to
 your own tastes and needs.</para>
@@ -32,23 +32,22 @@ less. Try that with a regular distribution.</para>
 
 <para>We could compare distributed Linux to a hamburger you buy at a
 fast-food restaurant. You have no idea what you are easting. LFS on the
-other hand, doesn't give you a hamburger, but the recipe to make a hamburger.
+other hand, doesn't give you a hamburger, but the recipe to make a hamburger. 
-This allows you to inspect it, omit unwanted ingredients, and allows you to
+This allows you to review it, omit unwanted ingredients, and allows you to
-add your own ingredients that enhance the flavour of your burger. When you
+add your own ingredients that enhance the flavor of your burger. When you
 are satisfied with the recipe, you go on to preparing it. You make it just
 the way you like it: broil it, bake it, deep-fry it, barbeque it, or eat it
-raw.</para>
+tar-tar (raw).</para>
 
 <para>Another analogy that we can use is that of comparing LFS with a 
-finished house. LFS will give you the skeleton of a house, but it's up 
+finished house. LFS will give you the skeletal plan of a house, but it's up 
-to you to install plumbing, electrical outlets, kitchen, bathtub, 
+to you to build it, giving you the freedom to adjust your plans as you go.</para>
-wallpaper, etc.</para>
 
-<para>Another advantage of a custom built Linux system is security. 
+<para>Another advantage of a custom built Linux system is security.
 By compiling the entire system from source code, you are empowered to audit
 everything and apply all the security patches you feel are needed. You don't 
 have to wait for somebody else to compile binary packages that fix a security
-hole. Examine the new patch and build it yourself.  You have no guarantee 
+hole. Examine the new patch and build it yourself. You have no guarantee 
 that the new package was built correctly and actually fixes the problem
 (adequately). You never truly know whether a security hole is fixed or
 not unless you do it yourself.</para>