Edit English idiom. punctuation, etc., throughout chapter 6.

This commit is contained in:
David Bryant 2022-11-03 19:24:54 -05:00
parent 172185a9f7
commit 6dff9ef949
5 changed files with 29 additions and 29 deletions

View File

@ -45,9 +45,9 @@
<!-- Don't remove this until Binutils upstream updates the libtool <!-- Don't remove this until Binutils upstream updates the libtool
copy. On some host distros the issue doesn't show up. --> copy. On some host distros the issue doesn't show up. -->
<para>Binutils ships an outdated libtool copy in the tarball. It lacks <para>Binutils ships an outdated copy of libtool in the tarball. It lacks
sysroot support so the produced binaries will be mistakenly linked to sysroot support, so the produced binaries will be mistakenly linked to
libraries from the host distro. Workaround this issue:</para> libraries from the host distro. Work around this issue:</para>
<screen><userinput remap="pre">sed '6009s/$add_dir//' -i ltmain.sh</userinput></screen> <screen><userinput remap="pre">sed '6009s/$add_dir//' -i ltmain.sh</userinput></screen>
@ -83,8 +83,8 @@ cd build</userinput></screen>
<varlistentry> <varlistentry>
<term><parameter>--enable-64-bit-bfd</parameter></term> <term><parameter>--enable-64-bit-bfd</parameter></term>
<listitem> <listitem>
<para>Enables 64-bit support (on hosts with narrower word sizes). <para>Enables 64-bit support (on hosts with smaller word sizes).
May not be needed on 64-bit systems, but does no harm.</para> This may not be needed on 64-bit systems, but it does no harm.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

View File

@ -45,8 +45,9 @@
<para> <para>
The <command>file</command> command on the build host needs The <command>file</command> command on the build host needs
to be same version as the one we are building in order to to be the same version as the one we are building in order to
create the signature file. Run the following commands to build it: create the signature file. Run the following commands to make a
temporary copy of the <command>file</command> command:
</para> </para>
<screen><userinput remap="pre">mkdir build <screen><userinput remap="pre">mkdir build

View File

@ -48,8 +48,7 @@
<screen><userinput remap="pre">patch -Np1 -i ../&gcc-upstream-fixes-patch;</userinput></screen> <screen><userinput remap="pre">patch -Np1 -i ../&gcc-upstream-fixes-patch;</userinput></screen>
--> -->
<para>As in the first build of GCC, the GMP, MPFR, and MPC packages are <para>As in the first build of GCC, the GMP, MPFR, and MPC packages are
required. Unpack the tarballs and move them into the required directory required. Unpack the tarballs and move them into the required directories:</para>
names:</para>
<screen><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz <screen><userinput remap="pre">tar -xf ../mpfr-&mpfr-version;.tar.xz
mv -v mpfr-&mpfr-version; mpfr mv -v mpfr-&mpfr-version; mpfr
@ -111,9 +110,9 @@ cd build</userinput></screen>
<para>Normally, using <parameter>--host</parameter> ensures that <para>Normally, using <parameter>--host</parameter> ensures that
a cross-compiler is used for building GCC, and that compiler knows a cross-compiler is used for building GCC, and that compiler knows
that it has to look for headers and libraries in <filename that it has to look for headers and libraries in <filename
class="directory">$LFS</filename>. But the build system of GCC uses class="directory">$LFS</filename>. But the build system for GCC uses
other tools, which are not aware of this location. This switch is other tools, which are not aware of this location. This switch is
needed to have them find the needed files in <filename needed so those tools will find the needed files in <filename
class="directory">$LFS</filename>, and not on the host.</para> class="directory">$LFS</filename>, and not on the host.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -121,16 +120,16 @@ cd build</userinput></screen>
<varlistentry> <varlistentry>
<term><parameter>--target=$LFS_TGT</parameter></term> <term><parameter>--target=$LFS_TGT</parameter></term>
<listitem> <listitem>
<para>As we are cross-compiling GCC, it's impossible to build <para>We are cross-compiling GCC, so it's impossible to build
target libraries (<filename class="libraryfile">libgcc</filename> target libraries (<filename class="libraryfile">libgcc</filename>
and <filename class="libraryfile">libstdc++</filename>) with the and <filename class="libraryfile">libstdc++</filename>) with the
compiled GCC binaries because these binaries won't run on the previously compiled GCC binaries&mdash;those binaries won't run on the
host distro. GCC building system will attempt to use the host. The GCC build system will attempt to use the host's
C and C++ compilers on the host distro as a workaround by default. C and C++ compilers as a workaround by default.
It's not supported to build GCC target libraries with a different Building the GCC target libraries with a different
version of GCC, so using host compilers may cause building version of GCC is not supported, so using the host's compilers may cause
failure. This parameter ensures to build the libraries with GCC the build to fail. This parameter ensures the libraries are built by GCC
pass 1 and prevent the issue.</para> pass 1.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -138,9 +137,9 @@ cd build</userinput></screen>
<term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term> <term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term>
<listitem> <listitem>
<para>Allow <filename class="libraryfile">libstdc++</filename> to <para>Allow <filename class="libraryfile">libstdc++</filename> to
use shared <filename class="libraryfile">libgcc</filename> being use the shared <filename class="libraryfile">libgcc</filename> being
built in this pass, instead of the static version built in GCC built in this pass, instead of the static version that was built in GCC
pass 1. This is needed for supporting C++ exception pass 1. This is necessary to support C++ exception
handling.</para> handling.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

View File

@ -16,7 +16,7 @@
the host's tools. Nevertheless, the installed libraries are used when the host's tools. Nevertheless, the installed libraries are used when
linking.</para> linking.</para>
<para>Using the utilities will be possible in next chapter after entering <para>Using the utilities will be possible in the next chapter after entering
the <quote>chroot</quote> environment. But all the packages built in the the <quote>chroot</quote> environment. But all the packages built in the
present chapter need to be built before we do that. Therefore we cannot be present chapter need to be built before we do that. Therefore we cannot be
independent of the host system yet.</para> independent of the host system yet.</para>

View File

@ -119,7 +119,7 @@ popd</userinput></screen>
<term><parameter>--without-ada</parameter></term> <term><parameter>--without-ada</parameter></term>
<listitem> <listitem>
<para>This ensures that Ncurses does not build support for the Ada <para>This ensures that Ncurses does not build support for the Ada
compiler which may be present on the host but will not be available compiler, which may be present on the host but will not be available
once we enter the <command>chroot</command> environment.</para> once we enter the <command>chroot</command> environment.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -127,9 +127,9 @@ popd</userinput></screen>
<varlistentry> <varlistentry>
<term><parameter>--disable-stripping</parameter></term> <term><parameter>--disable-stripping</parameter></term>
<listitem> <listitem>
<para>This switch prevents the building system from stripping <para>This switch prevents the building system from
the programs using <command>strip</command> program from the host. using the <command>strip</command> program from the host.
Using host tools on cross-compiled program can cause failure.</para> Using host tools on cross-compiled programs can cause failure.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -169,8 +169,8 @@ echo "INPUT(-lncursesw)" > $LFS/usr/lib/libncurses.so</userinput></screen>
<varlistentry> <varlistentry>
<term><parameter>TIC_PATH=$(pwd)/build/progs/tic</parameter></term> <term><parameter>TIC_PATH=$(pwd)/build/progs/tic</parameter></term>
<listitem> <listitem>
<para>We need to pass the path of the just built <para>We need to pass the path of the newly built
<command>tic</command> able to run on the building machine, so that <command>tic</command> program that runs on the building machine, so
the terminal database can be created without errors.</para> the terminal database can be created without errors.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>