cvs commit: LFS/BOOK/chapter02 askforhelp.xml download.xml

gerard at linuxfromscratch.org gerard at linuxfromscratch.org
Wed May 29 16:15:53 PDT 2002


gerard      02/05/29 16:15:53

  Modified:    BOOK/appendixa glibc-desc.xml introduction.xml
               BOOK/chapter02 askforhelp.xml download.xml
  Log:
  applied Alex's listed-items.patch
  
  Revision  Changes    Path
  1.17      +4 -4      LFS/BOOK/appendixa/glibc-desc.xml
  
  Index: glibc-desc.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/appendixa/glibc-desc.xml,v
  retrieving revision 1.16
  retrieving revision 1.17
  diff -u -r1.16 -r1.17
  --- glibc-desc.xml	26 May 2002 21:25:08 -0000	1.16
  +++ glibc-desc.xml	29 May 2002 23:15:53 -0000	1.17
  @@ -185,10 +185,10 @@
   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>
  
  
  
  1.9       +15 -17    LFS/BOOK/appendixa/introduction.xml
  
  Index: introduction.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/appendixa/introduction.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- introduction.xml	15 Dec 2001 14:28:34 -0000	1.8
  +++ introduction.xml	29 May 2002 23:15:53 -0000	1.9
  @@ -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 @@
   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>
   
  
  
  
  1.10      +16 -18    LFS/BOOK/chapter02/askforhelp.xml
  
  Index: askforhelp.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter02/askforhelp.xml,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- askforhelp.xml	11 May 2002 13:26:19 -0000	1.9
  +++ askforhelp.xml	29 May 2002 23:15:53 -0000	1.10
  @@ -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>
   
  
  
  
  1.13      +1 -1      LFS/BOOK/chapter02/download.xml
  
  Index: download.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter02/download.xml,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- download.xml	16 May 2002 18:40:04 -0000	1.12
  +++ download.xml	29 May 2002 23:15:53 -0000	1.13
  @@ -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
  
  
  
-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe lfs-book' in the subject header of the message



More information about the lfs-book mailing list