mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-06-19 03:39:20 +01:00
Edited fpr idiom and style. Broke up a couple of run-on sentences.
Mr. Webster says it's "up-front". Reworked one sentnece to avoid using a colon after the verb "to be".
This commit is contained in:
parent
eaf26ea596
commit
a0ed201f90
@ -13,7 +13,7 @@
|
|||||||
<para>If an issue or a question is encountered while working through
|
<para>If an issue or a question is encountered while working through
|
||||||
this book, please check the FAQ page at <ulink url="&faq-root;#generalfaq"/>.
|
this book, please check the FAQ page at <ulink url="&faq-root;#generalfaq"/>.
|
||||||
Questions are often already answered there. If your question is not
|
Questions are often already answered there. If your question is not
|
||||||
answered on this page, try to find the source of the problem. The
|
answered on that page, try to find the source of the problem. The
|
||||||
following hint will give you some guidance for troubleshooting:
|
following hint will give you some guidance for troubleshooting:
|
||||||
<ulink url="&hints-root;errors.txt"/>.</para>
|
<ulink url="&hints-root;errors.txt"/>.</para>
|
||||||
|
|
||||||
@ -23,18 +23,18 @@
|
|||||||
<para>We also have a wonderful LFS community that is willing to offer
|
<para>We also have a wonderful LFS community that is willing to offer
|
||||||
assistance through the mailing lists and IRC (see the <xref
|
assistance through the mailing lists and IRC (see the <xref
|
||||||
linkend="ch-intro-resources"/> section of this book). However,
|
linkend="ch-intro-resources"/> section of this book). However,
|
||||||
we get several support questions every day and many of them can be easily
|
we get several support questions every day, and many of them could have been easily
|
||||||
answered by going to the FAQ and by searching the mailing lists first.
|
answered by going to the FAQ or by searching the mailing lists first.
|
||||||
So, for us to offer the best assistance possible, you need to do some
|
So, for us to offer the best assistance possible, you should first do some
|
||||||
research on your own first. That allows us to focus on the more unusual
|
research on your own. That allows us to focus on the more unusual
|
||||||
support needs. If your searches do not produce a solution, please include
|
support needs. If your searches do not produce a solution, please include
|
||||||
all relevant information (mentioned below) in your request for help.</para>
|
all the relevant information (mentioned below) in your request for help.</para>
|
||||||
|
|
||||||
<sect2>
|
<sect2>
|
||||||
<title>Things to Mention</title>
|
<title>Things to Mention</title>
|
||||||
|
|
||||||
<para>Apart from a brief explanation of the problem being experienced,
|
<para>Apart from a brief explanation of the problem being experienced,
|
||||||
the essential things to include in any request for help are:</para>
|
any request for help should include these essential things:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
@ -50,7 +50,7 @@
|
|||||||
<para>The package or section the problem was encountered in</para>
|
<para>The package or section the problem was encountered in</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The exact error message or symptom being received</para>
|
<para>The exact error message, or a clear decription of the problem</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Note whether you have deviated from the book at all </para>
|
<para>Note whether you have deviated from the book at all </para>
|
||||||
@ -60,7 +60,7 @@
|
|||||||
<note>
|
<note>
|
||||||
<para>Deviating from this book does <emphasis>not</emphasis> mean that
|
<para>Deviating from this book does <emphasis>not</emphasis> mean that
|
||||||
we will not help you. After all, LFS is about personal preference.
|
we will not help you. After all, LFS is about personal preference.
|
||||||
Being upfront about any changes to the established procedure helps us
|
Being up-front about any changes to the established procedure helps us
|
||||||
evaluate and determine possible causes of your problem.</para>
|
evaluate and determine possible causes of your problem.</para>
|
||||||
</note>
|
</note>
|
||||||
|
|
||||||
@ -84,9 +84,9 @@
|
|||||||
in determining the cause of compilation problems. The screen output from
|
in determining the cause of compilation problems. The screen output from
|
||||||
the <command>configure</command> script and the <command>make</command>
|
the <command>configure</command> script and the <command>make</command>
|
||||||
run can be helpful. It is not necessary to include the entire output, but
|
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
|
do include all of the relevant information. Here is an example of the
|
||||||
type of information to include from the screen output from
|
type of information to include from the <command>make</command> screen
|
||||||
<command>make</command>:</para>
|
output.</para>
|
||||||
|
|
||||||
<screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\"
|
<screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\"
|
||||||
-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\"
|
-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\"
|
||||||
@ -112,16 +112,16 @@ make: *** [all-recursive-am] Error 2</computeroutput></screen>
|
|||||||
|
|
||||||
<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen>
|
<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen>
|
||||||
|
|
||||||
<para>This is not enough information to properly diagnose the problem
|
<para>This is not enough information to diagnose the problem,
|
||||||
because it only notes that something went wrong, not
|
because it only notes that something went wrong, not
|
||||||
<emphasis>what</emphasis> went wrong. The entire section, as in the
|
<emphasis>what</emphasis> went wrong. The entire section, as in the
|
||||||
example above, is what should be saved because it includes the command
|
example above, is what should be saved because it includes the command
|
||||||
that was executed and the associated error message(s).</para>
|
that was executed and all the associated error messages.</para>
|
||||||
|
|
||||||
<para>An excellent article about asking for help on the Internet is
|
<para>An excellent article about asking for help on the Internet is
|
||||||
available online at <ulink
|
available online at <ulink
|
||||||
url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and
|
url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read this document,
|
||||||
follow the hints in this document to increase the likelihood of getting
|
and follow the hints. Doing so will increase the likelihood of getting
|
||||||
the help you need.</para>
|
the help you need.</para>
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
Loading…
Reference in New Issue
Block a user