Changeset b716973 for introduction/common

Timestamp:

Jul 14, 2006, 3:23:41 PM (18 years ago)

Author:

Joe Ciccone <jciccone@…>

Children:

2b95da14

Parents:

ddaac6e

Message:

Updated the askforhelp page so we cant get more information about their build.

File:

• introduction/common/askforhelp.xml (modified) (4 diffs)

introduction/common/askforhelp.xml

@@ -24 +24 @@
   answered by going to the FAQ and by searching the mailing lists first.
   So for us to offer the best assistance possible, you need to do some
-  research on your own first. That allows us to focus on the more unusual
+  research on your own first. This allows us to focus on the more unusual
   support needs. If your searches do not produce a solution, please include
   all relevant information (mentioned below) in your request for help.</para>
@@ -41 +41 @@
       <listitem>
         <para>The host distribution and version being used to
-        create CLFS</para>
+        create CLFS.</para>
       </listitem>
       <listitem>
-        <para>The architecture of the target and host.</para>
+        <para>The architecture of the host and target.</para>
       </listitem>
       <listitem>
-        <para>The package or section the problem was encountered in</para>
+        <para>The value of the $CLFS_HOST, $CLFS_TARGET, $BUILD32, and $BUILD64
+        enviornment variables.</para>
       </listitem>
       <listitem>
-        <para>The exact error message or symptom being received</para>
+        <para>The package or section in which the problem was encountered.</para>
       </listitem>
       <listitem>
-        <para>Note whether you have deviated from the book at all </para>
+        <para>The exact error message or symptom received. See <xref
+        linkend="ch-intro-askforhelp-compilation-problems"/> below for an
+        example.</para>
+      </listitem>
+      <listitem>
+        <para>Note whether you have deviated from the book at all. A package
+        change or even a minor change to any command is considered deviation.
+        </para>
       </listitem>
     </itemizedlist>
@@ -60 +68 @@
       <para>Deviating from this book does <emphasis>not</emphasis>
       mean that we will not help you. After all, the CLFS project is
-      about personal preference. Being upfront about any changes to
-      the established procedure helps us evaluate and determine
+      about personal preference. Be upfront about any changes to
+      the established procedure, this helps us evaluate and determine
       possible causes of your problem.</para>
     </note>
@@ -72 +80 @@
     <para>If something goes wrong while running the <command>configure</command>
     script, review the <filename>config.log</filename> file. This file may
-    contain errors encountered during <command>configure</command> which were
-    not printed to the screen. Include the <emphasis>relevant</emphasis>
-    lines if you need to ask for help.</para>
+    contain the errors you encountered <command>configure</command>. This file
+    logs errors that may have not been printed to the screen. Include only the
+    <emphasis>relevant</emphasis> lines if you need to ask for help.</para>
 
   </sect2>
 
-  <sect2>
+  <sect2 id="ch-intro-askforhelp-compilation-problems">
     <title>Compilation Problems</title>