aboutsummaryrefslogtreecommitdiffstats
path: root/chapter01/askforhelp.xml
diff options
context:
space:
mode:
authorMatthew Burgess <matthew@linuxfromscratch.org>2004-05-03 10:59:46 +0000
committerMatthew Burgess <matthew@linuxfromscratch.org>2004-05-03 10:59:46 +0000
commit673b0d84ba9591e07c0bdf0ee49d92eba10f502c (patch)
tree129e27a1450727b440da4378e0117a468eb9c25e /chapter01/askforhelp.xml
parent287ea55da70ceb1f0990554b7db921d525fef816 (diff)
* Merged newxml into HEAD
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3435 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter01/askforhelp.xml')
-rw-r--r--chapter01/askforhelp.xml18
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>
-