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

This commit is contained in:
David Bryant 2022-09-27 13:42:07 -05:00
parent ec7b046623
commit ef93b66006
2 changed files with 17 additions and 17 deletions

View File

@ -13,25 +13,25 @@
<para>Many people would like to know beforehand approximately how long <para>Many people would like to know beforehand approximately how long
it takes to compile and install each package. Because Linux From it takes to compile and install each package. Because Linux From
Scratch can be built on many different systems, it is impossible to 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 take approximately 20 minutes on the fastest systems, but could take
up to three days on slower systems! Instead of providing actual times, up to three days on slower systems! Instead of providing actual times,
the Standard Build Unit (SBU) measure will be the Standard Build Unit (SBU) measure will be
used instead.</para> used instead.</para>
<para>The SBU measure works as follows. The first package to be compiled <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 is binutils in <xref linkend="chapter-cross-tools"/>. The
time it takes to compile this package is what will be referred to as 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 relative Standard Build Unit or SBU. All other compile times will be expressed in
to this time.</para> terms of this unit of time.</para>
<para>For example, consider a package whose compilation time is 4.5 <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 install the first pass of binutils, it will take
<emphasis>approximately</emphasis> 45 minutes to build this example package. <emphasis>approximately</emphasis> 45 minutes to build the example package.
Fortunately, most build times are shorter than the one for binutils.</para> 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 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 to give an estimate of how long it might take to install a package, but the
numbers can vary by as much as dozens of minutes in some cases.</para> numbers can vary by as much as dozens of minutes in some cases.</para>
@ -45,15 +45,15 @@
<screen role="nodump"><userinput>export MAKEFLAGS='-j4'</userinput></screen> <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> <screen role="nodump"><userinput>make -j4</userinput></screen>
<para>When multiple processors are used in this way, the SBU units in the <para>When multiple processors are used in this way, the SBU units in the
book will vary even more than they normally would. In some cases, the make 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 step will simply fail. Analyzing the output of the build process will also
be more difficult because the lines of different processes will be be more difficult because the lines from different processes will be
interleaved. If you run into a problem with a build step, revert back to a interleaved. If you run into a problem with a build step, revert to a
single processor build to properly analyze the error messages.</para> single processor build to properly analyze the error messages.</para>
</note> </note>

View File

@ -27,21 +27,21 @@
<note> <note>
<para>Running the test suites in <xref linkend="chapter-cross-tools"/> <para>Running the test suites in <xref linkend="chapter-cross-tools"/>
and <xref linkend="chapter-temporary-tools"/> and <xref linkend="chapter-temporary-tools"/>
is impossible, since the programs are compiled with a cross-compiler, is pointless; since the test programs are compiled with a cross-compiler,
so are not supposed to be able to run on the build host.</para> they probably can't run on the build host.</para>
</note> </note>
<para>A common issue with running the test suites for binutils and GCC <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 number of failing tests. This may happen for several reasons, but the
most likely cause is that the host system does not have the most likely cause is that the host system does not have the
<systemitem class="filesystem">devpts</systemitem> file system set up <systemitem class="filesystem">devpts</systemitem> file system set up
correctly. This issue is discussed in greater detail at correctly. This issue is discussed in greater detail at
<ulink url="&lfs-root;lfs/faq.html#no-ptys"/>.</para> <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 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 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> </sect1>