Changeset 5d21368 in clfs-sysroot for BOOK/introduction/common/askforhelp.xml

Timestamp:

Jul 16, 2006, 6:03:31 PM (18 years ago)

Author:

Joe Ciccone <jciccone@…>

Branches:

master

Children:

fe4de21

Parents:

7e8c096

Message:

Added the missing parts of ask for help page from r2142.

File:

• BOOK/introduction/common/askforhelp.xml (modified) (5 diffs)

BOOK/introduction/common/askforhelp.xml

@@ -17 +17 @@
   following hint will give you some guidance for troubleshooting:
   <ulink url="&hints-root;errors.txt"/>.</para>
-
-  <para>If you cannot find your problem listed in the FAQ, search the mailing
-  lists at <ulink url="&lfs-root;search.html"/>.</para>
 
   <para>We also have a wonderful CLFS community that is willing to offer
@@ -44 +41 @@
       <listitem>
         <para>The host distribution and version being used to
-        create LFS</para>
+        create CLFS.</para>
       </listitem>
       <listitem>
-        <para>The package or section the problem was encountered in</para>
+        <para>The architecture of the host and target.</para>
       </listitem>
       <listitem>
-        <para>The exact error message or symptom being received</para>
+        <para>The value of the $CLFS_HOST, $CLFS_TARGET, $BUILD32, and $BUILD64
+        environment variables.</para>
       </listitem>
       <listitem>
-        <para>Note whether you have deviated from the book at all </para>
+        <para>The package or section in which the problem was encountered.</para>
+      </listitem>
+      <listitem>
+        <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
+        version 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 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>
+    contain the errors you encountered during <command>configure</command>.
+    It often 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>
@@ -99 +108 @@
 default.o remote-stub.o version.o opt1.o
 -lutil job.o: In function `load_too_high':
-/lfs/tmp/make-3.79.1/job.c:1565: undefined reference
+/clfs/tmp/make-3.79.1/job.c:1565: undefined reference
 to `getloadavg'
 collect2: ld returned 1 exit status
 make[2]: *** [make] Error 1
-make[2]: Leaving directory `/lfs/tmp/make-3.79.1'
+make[2]: Leaving directory `/clfs/tmp/make-3.79.1'
 make[1]: *** [all-recursive] Error 1
-make[1]: Leaving directory `/lfs/tmp/make-3.79.1'
+make[1]: Leaving directory `/clfs/tmp/make-3.79.1'
 make: *** [all-recursive-am] Error 2</computeroutput></screen>