applied Alex's listed-items.patch

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

4 files changed, 36 insertions, 40 deletions

diff --git a/appendixa/glibc-desc.xml b/appendixa/glibc-desc.xml
index 62b6efc1e..f3ee7c291 100644
--- a/appendixa/glibc-desc.xml
+++ b/appendixa/glibc-desc.xml
@@ -185,10 +185,10 @@ libnss_hesiod, libnss_nis, libnss_nisplus</title>
 offered to access the databases in separate modules. This has some
 advantages:</para>
 <itemizedlist>
-<listitem><para>Contributors can add new services without adding them to
-GNU C Library.</para></listitem>
-<listitem><para>The modules can be updated separately.</para></listitem>
-<listitem><para>The C library image is smaller.</para></listitem>
+<listitem><para>contributors can add new services without adding them to
+GNU C library,</para></listitem>
+<listitem><para>the modules can be updated separately,</para></listitem>
+<listitem><para>the C library image is smaller.</para></listitem>
 </itemizedlist></sect4>
 
 <sect4><title>libpcprofile</title>
diff --git a/appendixa/introduction.xml b/appendixa/introduction.xml
index 504699147..c5c231042 100644
--- a/appendixa/introduction.xml
+++ b/appendixa/introduction.xml
@@ -2,32 +2,31 @@
 <title>Introduction</title>
 <?dbhtml filename="introduction.html" dir="appendixa"?>
 
-<para>This appendix describes the following aspects of every package
-that is installed in this book:</para>
+<para>In this appendix the following aspects of every package
+installed in this book are described:</para>
 
 <itemizedlist>
 
-<listitem><para>The official download location for the 
-package.</para></listitem>
+<listitem><para>the official download location for the 
+package,</para></listitem>
 
-<listitem><para>What the package contains.</para></listitem>
+<listitem><para>what the package contains,</para></listitem>
 
-<listitem><para>What each program from a package does.</para></listitem>
+<listitem><para>what each program from the package does,</para></listitem>
 
-<listitem><para>What each package needs to compile.</para></listitem>
+<listitem><para>what the package needs to be compiled.</para></listitem>
 
 </itemizedlist>
 
 <para>Most information about these packages (especially the descriptions of
-them) come from the man pages from those packages. We are not going to print
-the entire man page, just the core elements to make it possible to
-understand what a program does. To get knowledge of all details on a program, 
-we suggest you start by reading the complete man page in addition to 
-this appendix.</para>
+them) come from the man pages of those packages. We do not include
+the entire man page, but just some key elements to make it possible to
+understand what a program does. To get information on all details of a program, 
+please refer to its man page or info page.</para>
 
 <para>Certain packages are documented in more depth
 than others, because we just happen to know more about certain
-packages than I know about others. If anything should be added to the
+packages than about others. If you think anything should be added to the
 following descriptions, please don't hesitate to email the mailing
 lists.  We intend that the list should contain an in-depth description 
 of every package installed, but we can't do it without help.</para>
@@ -45,12 +44,11 @@ what programs are needed to use that packages programs. Just the ones
 needed to compile it.</para>
 
 <para>The dependency list can be, from time to time, outdated in regards
-to the current used package version. Checking dependencies takes quite a
+to the currently used package version. Checking dependencies takes quite a
 bit of work, so they may lag behind a bit on the package update. But
 often with minor package updates, the installation dependencies hardly
-change, so they'll be current in most cases. If we upgrade to a major
-new release, we'll make sure the dependencies are checked too at the
-same time.</para>
+change, so they'll be current in most cases. When we upgrade to a major
+new release, we'll make sure the dependencies are checked too.</para>
 
 </sect1>
 
diff --git a/chapter02/askforhelp.xml b/chapter02/askforhelp.xml
index feba21a79..790169050 100644
--- a/chapter02/askforhelp.xml
+++ b/chapter02/askforhelp.xml
@@ -2,31 +2,29 @@
 <title>How to ask for help</title>
 <?dbhtml filename="askforhelp.html" dir="chapter02"?>
 
-<para>If you have a problem while using this book, you'll find that most
-of the people on Internet Relay Chat (IRC) and the mailing lists will be
-willing to help you.  You can find a list of the LFS mailing lists in
-<xref linkend="ch01-maillists"/>.  To assist us in helping though, you should
-make sure that you have as much relevant information as you can
-available.  This will assist in diagnosing and solving your problem.
-This part of the book will guide you as to which sort of information
-will be useful.</para>
+<para>If you encounter a problem while using this book, you'll 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 you can find in
+<xref linkend="ch01-maillists"/>.)  To assist us in diagnosing and solving
+your problem, make sure to include as much relevant information
+as possible in your request for help.</para>
 
 <sect2>
-<title>Basic Information</title>
+<title>Things to mention</title>
  
-<para>First of all we need a brief explanation of the problem.
-Essential things to include are:</para>
+<para>Apart from a brief explanation of the problem you're having, the
+essential things to include in your request are:</para>
 
 <itemizedlist>
-<listitem><para>The version of the book you are using, which is &version;</para></listitem>
-<listitem><para>Which package or section you are having problems with</para></listitem>
-<listitem><para>What the exact error message or symptom you are receiving is</para></listitem>
-<listitem><para>If you have deviated from the book at all</para></listitem>
+<listitem><para>the version of the book you are using (being &version;),</para></listitem>
+<listitem><para>the package or section you are having problems with,</para></listitem>
+<listitem><para>the exact error message or symptom you are receiving,</para></listitem>
+<listitem><para>whether you have deviated from the book at all.</para></listitem>
 </itemizedlist>
 
-<para>Note that saying that you've deviated from the book doesn't mean
-that we won't help you, after all, LFS is all about choice.  It'll just
-help us to see the possible other causes of your problem.</para>
+<para>(Note that saying that you've deviated from the book doesn't mean
+that we won't help you.  After all, LFS is about choice.  It'll just
+help us to see other possible causes of your problem.)</para>
 
 </sect2>
 
diff --git a/chapter02/download.xml b/chapter02/download.xml
index 6195992ec..d8ff18345 100644
--- a/chapter02/download.xml
+++ b/chapter02/download.xml
@@ -1,5 +1,5 @@
 <sect1 id="ch02-download">
-<title>How to download the software</title>
+<title>Where to store the downloaded software</title>
 <?dbhtml filename="download.html" dir="chapter02"?>
 
 <para>Throughout this document, we will assume that all the