diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml index efc42dd24..835c91bb0 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. diff --git a/prologue/errata.xml b/prologue/errata.xml index fa919bcca..275eac7da 100644 --- a/prologue/errata.xml +++ b/prologue/errata.xml @@ -13,18 +13,18 @@ The software used to create an LFS system is constantly being updated and enhanced. Security warnings and bug fixes may become available after the LFS book has been released. To check whether the package versions or - instructions in this release of LFS need any modifications to accommodate - security vulnerabilities or other bug fixes, please visit + instructions in this release of LFS need any modifications—to repair + security vulnerabilities or to fix other bugs—please visit before proceeding with your build. You should note any - changes shown and apply them to the relevant section of the book as you - progress with building the LFS system. + changes shown and apply them to the relevant sections of the book as you + build the LFS system. In addition, the Linux From Scratch editors maintain a list of security - vulnerabilities discovered after a book was released. To check whether there - are any active security vulnerabilities, please visit - prior to proceeding with your build. You should note - any advisories and perform the steps to fix any security vulnerabilities as - you progress with building the LFS system. + vulnerabilities discovered after a book has been released. To see + whether there are any known security vulnerabilities, please visit + before proceeding with your build. You should also continue + to consult the advisories, and fix any security vulnerabilities, even + when the LFS system has been completely constructed.