diff options
Diffstat (limited to 'chapter01/askforhelp.xml')
| -rw-r--r-- | chapter01/askforhelp.xml | 18 |
1 files changed, 11 insertions, 7 deletions
diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml index b04a8161b..747a74b92 100644 --- a/chapter01/askforhelp.xml +++ b/chapter01/askforhelp.xml @@ -1,9 +1,14 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> <sect1 id="prepare-askforhelp"> <title>How to ask for help</title> -<?dbhtml filename="askforhelp.html" dir="chapter01"?> +<?dbhtml filename="askforhelp.html"?> <para>If you run into a problem while working through this book, you should -first check the FAQ at <ulink url="&faq-root;"/> -- most likely your question +first check the FAQ at <ulink url="&faq-root;"/> -- often your question is already answered there. If it is not, you should try to find the source of the problem. The following hint might give you some ideas for your troubleshooting: <ulink url="&hints-root;errors.txt"/>.</para> @@ -22,7 +27,7 @@ essential things to include in your request are:</para> <itemizedlist> <listitem><para>the version of the book you are using (being &version;),</para></listitem> <listitem><para>the host distribution and version you are using to create -LFS from,</para></listitem> +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>whether you have deviated from the book at all.</para></listitem> @@ -51,7 +56,7 @@ help.</para> <para>To help us find the cause of the problem, both screen output and the contents of various files are useful. The screen output from both the ./configure script and the make run can be useful. Don't blindly -include the whole thing but on the other hand, don't include too little. +include the whole thing but, on the other hand, don't include too little. As an example, here is some screen output from make:</para> <screen>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\" @@ -82,8 +87,8 @@ above, is what should be included to be helpful, because it includes the command that was executed and the command's error message(s).</para> <para>An excellent article on asking for help on the Internet in general -has been written by Eric S. Raymond. It is available online at <ulink -url="http://catb.org/~esr/faqs/smart-questions.html"/>. +has been written by Eric S. Raymond. It is available online at +<ulink url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and follow the hints in that document and you are much more likely to get a response to start with and also to get the help you actually need.</para> @@ -104,4 +109,3 @@ about them, then usually there is no need to be concerned.</para> </sect1> - |