Changeset 5d21368 in clfs-sysroot

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.

Location:

BOOK/introduction/common

Files:

• askforhelp.xml (modified) (5 diffs)
• how.xml (modified) (1 diff)

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>
 

BOOK/introduction/common/how.xml

@@ -21 +21 @@
   <para>As an alternative to installing an entire separate distribution
   onto your machine, you may wish to use the Linux From Scratch LiveCD.
-  The CD works well as a host system, providing all the tools you need to
-  successfully follow the instructions in this book. Additionally, it
-  contains all the source packages, patches and a copy of this book. So
-  once you have the CD, no network connection or additional downloads are
-  necessary. For more information about the LFS LiveCD or to download a copy,
-  visit <ulink url="&livecd-root;"/></para>
+  This CD works well as a host system, providing all the tools you need to
+  successfully follow the instructions in this book. It does also
+  contain source packages and patches for the LFS book, and a copy of the LFS
+  book, but not the needed packages or book for CLFS. You can still use the
+  CD for building CLFS, but you will need to download the packages, patches
+  and book separately. You can also look at
+  <ulink url="&hints-root;lfscd-remastering-howto.txt"/>
+  for infomation on building your own CD, replacing the LFS packages and book
+  with those for CLFS. Once you have the CD, no network connection or
+  additional downloads are necessary. For more information about the LFS
+  LiveCD or to download a copy, visit <ulink url="&livecd-root;"/>.</para>
 
   <para><xref linkend="chapter-partitioning"/> of this book describes how