diff --git a/part3intro/generalinstructions.xml b/part3intro/generalinstructions.xml
index ac2bcc675..f3285bc17 100644
--- a/part3intro/generalinstructions.xml
+++ b/part3intro/generalinstructions.xml
@@ -11,29 +11,29 @@
General Compilation Instructions
- When building packages there are several assumptions made within
- the instructions:
+ Here are some things you should know about building each package:
- Several of the packages are patched before compilation, but only when
+ Several packages are patched before compilation, but only when
the patch is needed to circumvent a problem. A patch is often needed in
- both this and the following chapters, but sometimes in only one location.
+ both the current and the following chapters, but sometimes, when the same package
+ is built more than once, the patch is not needed right away.
Therefore, do not be concerned if instructions for a downloaded patch seem
to be missing. Warning messages about offset or
fuzz may also be encountered when applying a patch. Do
- not worry about these warnings, as the patch was still successfully
+ not worry about these warnings; the patch was still successfully
applied.
- During the compilation of most packages, there will be several
- warnings that scroll by on the screen. These are normal and can safely be
- ignored. These warnings are as they appear—warnings about
+ During the compilation of most packages, some
+ warnings will scroll by on the screen. These are normal and can safely be
+ ignored. These warnings are usually about
deprecated, but not invalid, use of the C or C++ syntax. C standards change
- fairly often, and some packages still use the older standard. This is not a
- problem, but does prompt the warning.
+ fairly often, and some packages have not yet been updated. This is not a
+ serious problem, but it does cause the warnings to appear.
@@ -69,25 +69,25 @@
symbolic link to gawk.
/usr/bin/yacc is a
- symbolic link to bison or a small script that
+ symbolic link to bison, or to a small script that
executes bison.
- To re-emphasize the build process:
+ Here is a synopsis of the build process.
Place all the sources and patches in a directory that will be
- accessible from the chroot environment such as
+ accessible from the chroot environment, such as
/mnt/lfs/sources/.
- Change to the sources directory.
+ Change to the /mnt/lfs/sources/ directory.
For each package:
@@ -97,22 +97,21 @@
to be built. In and
, ensure you are
the lfs user when extracting the package.
- All methods to get the source code tree being built
- in-position, except extracting the package tarball, are not
- supported. Notably, using cp -R to copy the
+ Do not use any method except the tar command
+ to extract the source code. Notably, using the cp -R
+ command to copy the
source code tree somewhere else can destroy links and
- timestamps in the sources tree and cause building
- failure.
+ timestamps in the source tree, and cause the build to fail.
Change to the directory created when the package was
extracted.
- Follow the book's instructions for building the package.
+ Follow the instructions for building the package.
- Change back to the sources directory.
+ Change back to the sources directory when the build is complete.
Delete the extracted source directory unless instructed otherwise.