From a0ed201f90dc67a06dbcd58eccfcb7430b2139e8 Mon Sep 17 00:00:00 2001 From: David Bryant Date: Fri, 21 Oct 2022 14:05:59 -0500 Subject: 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". --- chapter01/askforhelp.xml | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml index f7a9d1efa..1edf8f349 100644 --- a/chapter01/askforhelp.xml +++ b/chapter01/askforhelp.xml @@ -13,7 +13,7 @@ If an issue or a question is encountered while working through this book, please check the FAQ page at . 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: . @@ -23,18 +23,18 @@ We also have a wonderful LFS community that is willing to offer assistance through the mailing lists and IRC (see the section of this book). However, - we get several support questions every day and many of them can be easily - answered by going to the FAQ and by searching the mailing lists first. - So, for us to offer the best assistance possible, you need to do some - research on your own first. That allows us to focus on the more unusual + we get several support questions every day, and many of them could have been easily + answered by going to the FAQ or by searching the mailing lists first. + So, for us to offer the best assistance possible, you should first do some + 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 - all relevant information (mentioned below) in your request for help. + all the relevant information (mentioned below) in your request for help. Things to Mention Apart from a brief explanation of the problem being experienced, - the essential things to include in any request for help are: + any request for help should include these essential things: @@ -50,7 +50,7 @@ The package or section the problem was encountered in - The exact error message or symptom being received + The exact error message, or a clear decription of the problem Note whether you have deviated from the book at all @@ -60,7 +60,7 @@ Deviating from this book does not mean that 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. @@ -84,9 +84,9 @@ in determining the cause of compilation problems. The screen output from the configure script and the make 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 - type of information to include from the screen output from - make: + do include all of the relevant information. Here is an example of the + type of information to include from the make screen + output. gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\" -DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" @@ -112,16 +112,16 @@ make: *** [all-recursive-am] Error 2 make [2]: *** [make] Error 1 - This is not enough information to properly diagnose the problem + This is not enough information to diagnose the problem, because it only notes that something went wrong, not what went wrong. The entire section, as in the example above, is what should be saved because it includes the command - that was executed and the associated error message(s). + that was executed and all the associated error messages. An excellent article about asking for help on the Internet is available online at . Read and - follow the hints in this document to increase the likelihood of getting + url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read this document, + and follow the hints. Doing so will increase the likelihood of getting the help you need. -- cgit v1.2.3-54-g00ecf