Changeset ef93b66

Timestamp:

09/27/2022 06:42:07 PM (19 months ago)

Author:

David Bryant <davidbryant@…>

Branches:

11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

dd7f9df

Parents:

ec7b0466

Message:

Adjust English idiom and clarify directions (chapters 4.5 and 4.6).

Location:

chapter04

Files:

• aboutsbus.xml (modified) (4 diffs)
• abouttestsuites.xml (modified) (2 diffs)

chapter04/aboutsbus.xml

@@ -14 +14 @@
   it takes to compile and install each package. Because Linux From
   Scratch can be built on many different systems, it is impossible to
-  provide accurate time estimates. The biggest package (Glibc) will
+  provide absolute time estimates. The biggest package (Glibc) will
   take approximately 20 minutes on the fastest systems, but could take
   up to three days on slower systems! Instead of providing actual times,
@@ -21 +21 @@
 
   <para>The SBU measure works as follows. The first package to be compiled
-  from this book is binutils in <xref linkend="chapter-cross-tools"/>. The
-  time it takes to compile this package is what will be referred to as the
-  Standard Build Unit or SBU. All other compile times will be expressed relative
-  to this time.</para>
+  is binutils in <xref linkend="chapter-cross-tools"/>. The
+  time it takes to compile this package is what we will refer to as the
+  Standard Build Unit or SBU. All other compile times will be expressed in
+  terms of this unit of time.</para>
 
   <para>For example, consider a package whose compilation time is 4.5
-  SBUs. This means that if a system took 10 minutes to compile and
+  SBUs. This means that if your system took 10 minutes to compile and
   install the first pass of binutils, it will take
-  <emphasis>approximately</emphasis> 45 minutes to build this example package.
-  Fortunately, most build times are shorter than the one for binutils.</para>
+  <emphasis>approximately</emphasis> 45 minutes to build the example package.
+  Fortunately, most build times are shorter than one SBU.</para>
 
-  <para>In general, SBUs are not entirely accurate because they depend on many
+  <para>SBUs are not entirely accurate because they depend on many
   factors, including the host system's version of GCC.  They are provided here
   to give an estimate of how long it might take to install a package, but the
@@ -46 +46 @@
     <screen role="nodump"><userinput>export MAKEFLAGS='-j4'</userinput></screen>
 
-    <para>or just building with:</para>
+    <para>or by building with:</para>
 
     <screen role="nodump"><userinput>make -j4</userinput></screen>
@@ -53 +53 @@
     book will vary even more than they normally would.  In some cases, the make
     step will simply fail.  Analyzing the output of the build process will also
-    be more difficult because the lines of different processes will be
-    interleaved.  If you run into a problem with a build step, revert back to a
+    be more difficult because the lines from different processes will be
+    interleaved.  If you run into a problem with a build step, revert to a
     single processor build to properly analyze the error messages.</para>
   </note>

chapter04/abouttestsuites.xml

@@ -28 +28 @@
     <para>Running the test suites in <xref linkend="chapter-cross-tools"/>
     and <xref linkend="chapter-temporary-tools"/>
-    is impossible, since the programs are compiled with a cross-compiler,
-    so are not supposed to be able to run on the build host.</para>
+    is pointless; since the test programs are compiled with a cross-compiler,
+    they probably can't run on the build host.</para>
   </note>
 
   <para>A common issue with running the test suites for binutils and GCC
-  is running out of pseudo terminals (PTYs). This can result in a high
+  is running out of pseudo terminals (PTYs). This can result in a large
   number of failing tests. This may happen for several reasons, but the
   most likely cause is that the host system does not have the
@@ -40 +40 @@
   <ulink url="&lfs-root;lfs/faq.html#no-ptys"/>.</para>
 
-  <para>Sometimes package test suites will fail, but for reasons which the
+  <para>Sometimes package test suites will fail for reasons which the
   developers are aware of and have deemed non-critical. Consult the logs located
   at <ulink url="&test-results;"/> to verify whether or not these failures are
-  expected. This site is valid for all tests throughout this book.</para>
+  expected. This site is valid for all test suites throughout this book.</para>
 
 </sect1>