Changeset 69993f4 for chapter01/askforhelp.xml

Timestamp:

08/29/2004 06:36:34 PM (20 years ago)

Author:

Gerard Beekmans <gerard@…>

Branches:

6.0

Children:

8b320e7

Parents:

ec0a37e6

Message:

Second round of edits for final release

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/testing/BOOK@4066 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• chapter01/askforhelp.xml (modified) (4 diffs)

chapter01/askforhelp.xml

@@ -8 +8 @@
 <?dbhtml filename="askforhelp.html"?>
 
-<para>If you encounter an issue or have a question while working
-through this book, check our FAQs page at <ulink url="&faq-root;"/>.
-Often times questions are already answered there. If your question is
+<para>If an issue or a question is encountered while working
+through this book, check the FAQ page at <ulink url="&faq-root;"/>.
+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
@@ -18 +18 @@
 assistance through IRC and the mailing lists (see the <xref
 linkend="ch-scatter-administrativa"/> section of this book). In order
-to assist them with diagnosing and solving the problem, please include
+to assist with diagnosing and solving the problem, please include
 all relevant information in your request for help.</para>
 
 <sect2>
-<title>Things to mention</title>
+<title>Things to Mention</title>
  
-<para>Apart from a brief explanation of the problem being experience,
-the essential things to include in your request for help are:</para>
+<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 you are using (in this case
+<listitem><para>The version of the book being used (in this case
 &version;)</para></listitem>
-<listitem><para>The host distribution and version you are using to
+<listitem><para>The host distribution and version being used to
 create LFS</para></listitem>
-<listitem><para>The package or section giving you problems</para></listitem>
-<listitem><para>The exact error message or symptom you are receiving</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 won't help you. After all, LFS is about your personal
-preference. Being upfront any changes to the established procedure
-help us evaluate and determine possible causes of your
+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 problems</title>
+<title>Configure Problems</title>
 
 <para>If something goes wrong during the stage where the configure
@@ -57 +57 @@
 <title>Compile problems</title>
 
-<para>The both screen output and the contents of various files are
+<para>Both the screen output and the contents of various files are
 useful in determining the cause of compile issues. The screen output
-from both the ./configure script and the make run can be helpful. It
+from the ./configure script and the make 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
@@ -94 +94 @@
 available online at <ulink
 url="http://catb.org/~esr/faqs/smart-questions.html"/>.  Read and
-follow the hints in this document to increase your changes of getting
+follow the hints in this document to increase the likelihood of getting
 the help you need.</para>
 </sect2>
 
 <sect2>
-<title>Test suite problems</title>
+<title>Test Suite Problems</title>
 
 <para>Many packages provide a test suite which, depending on the