Adapting the title of the 'Locking in' section.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3249 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

chapter05/binutils-pass1.xml

@@ -83,7 +83,7 @@ the second pass.</para>
 
 <screen><userinput>make install</userinput></screen>
 
-<para>Now prepare the linker for the "locking in" of Glibc later on:</para>
+<para>Now prepare the linker for the "Adjusting" phase later on:</para>
 
 <screen><userinput>make -C ld clean
 make -C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput></screen>
@@ -107,9 +107,9 @@ chapter.</para></listitem>
 <!-- HACK - Force some whitespace to appease tidy -->
 <literallayout></literallayout>
 
-<warning><para>Do not yet remove the Binutils build and source directories. You
-will need them again in their current state a bit further on in this
-chapter.</para></warning>
+<warning><para><emphasis>Do not yet remove</emphasis> the Binutils build and
+source directories. You will need them again in their current state a bit
+further on in this chapter.</para></warning>
 
 <!-- HACK - Force some whitespace to appease tidy -->
 <literallayout></literallayout>

chapter05/binutils-pass2.xml

@@ -58,7 +58,7 @@ should be easy to spot. The output shown will contain something like:</para>
 
 <screen><userinput>make install</userinput></screen>
 
-<para>Now prepare Binutils for the re-adjusting of the toolchain in the next
+<para>Now prepare the linker for the "Re-adjusting" phase in the next
 chapter:</para>
 
 <screen><userinput>make -C ld clean
@@ -67,9 +67,9 @@ make -C ld LIB_PATH=/usr/lib:/lib</userinput></screen>
 <!-- HACK - Force some whitespace to appease tidy -->
 <literallayout></literallayout>
 
-<warning><para>Do not yet remove the Binutils source and build directories.
-We'll need these directories again in the next chapter in the state they are in
-now.</para></warning>
+<warning><para><emphasis>Do not yet remove</emphasis> the Binutils source and
+build directories. You will need these directories again in the next chapter
+in the state they are in now.</para></warning>
 
 <!-- HACK - Force some whitespace to appease tidy -->
 <literallayout></literallayout>

chapter05/chapter05.xml

@@ -439,23 +439,24 @@ temporary tools, source the just-created profile:</para>
 &c5-glibc;
 
 
-<sect1 id="ch-tools-locking-glibc">
-<title>"Locking in" Glibc</title>
-<?dbhtml filename="lockingglibc.html" dir="chapter05"?>
+<sect1 id="ch-tools-adjusting">
+<title>Adjusting the toolchain</title>
+<?dbhtml filename="adjusting.html" dir="chapter05"?>
 
 <para>Now that the temporary C libraries have been installed, we want all
 the tools compiled in the rest of this chapter to be linked against these
 libraries. To accomplish this, we need to adjust the linker and the compiler's
-specs file.</para>
+specs file. Some people would say that it is <emphasis>"black magic juju below
+this line"</emphasis>, but it is really very simple.</para>
 
-<para>First install the adjusted linker by running the following from within
+<para>First install the adjusted linker (adjusted at the end of the first pass
+of Binutils) by running the following command from within
 the <filename class="directory">binutils-build</filename> directory:</para>
 
 <screen><userinput>make -C ld install</userinput></screen>
 
-<para>The linker was adjusted a little while back, at the end of the first
-pass of Binutils. From this point onwards everything will link <emphasis>only
-</emphasis> against the libraries in <filename>/tools/lib</filename>.</para>
+<para>From this point onwards everything will link <emphasis>only</emphasis>
+against the libraries in <filename>/tools/lib</filename>.</para>
 
 <note><para>If you somehow missed the earlier warning to retain the Binutils
 source and build directories from the first pass or otherwise accidentally
@@ -465,8 +466,8 @@ testing programs linking against libraries on the host. This is not ideal, but
 it's not a major problem. The situation is corrected when we install the
 second pass of Binutils a bit further on.</para></note>
 
-<para>Now that the adjusted linker is installed, you have to remove the
-Binutils build and source directories.</para>
+<para>Now that the adjusted linker is installed, you have to
+<emphasis>remove</emphasis> the Binutils build and source directories.</para>
 
 <para>The next thing to do is to amend our GCC specs file so that it points
 to the new dynamic linker. A simple sed will accomplish this:</para>
@@ -541,9 +542,6 @@ ensuring to cut-and-paste the commands as was recommended.</para>
 <!-- HACK - Force some whitespace to appease tidy -->
 <literallayout></literallayout>
 
-<para>This completes the installation of the self-contained toolchain, and it
-can now be used to build the rest of the temporary tools.</para>
-
 </sect1>
 
 

chapter05/gcc-pass2.xml

@@ -167,8 +167,8 @@ to continue on.</para>
 <screen><userinput>make install</userinput></screen>
 
 <note><para>At this point it is strongly recommended to repeat the sanity check
-we performed earlier in the chapter. Refer back to
-<xref linkend="ch-tools-locking-glibc"/> and repeat the check. If the results are
+we performed earlier in this chapter. Refer back to
+<xref linkend="ch-tools-adjusting"/> and repeat the check. If the results are
 wrong, then most likely you forgot to apply the above mentioned GCC Specs
 patch.</para></note>
 

chapter06/chapter06.xml

@@ -357,16 +357,21 @@ file records the bad login attempts.</para>
 &c6-glibc;
 
 
-<sect1 id="ch-system-adjustingtoolchain">
+<sect1 id="ch-system-readjusting">
 <title>Re-adjusting the toolchain</title>
-<?dbhtml filename="adjustingtoolchain.html" dir="chapter06"?>
-
-<para>Now that the new C libraries have been installed, it's time to re-adjust
-our toolchain. We'll adjust it so that it will link any newly compiled program
-against the new C libraries. Basically, this is the reverse of what we did
-in the "locking in" stage in the beginning of the previous chapter.</para>
-
-<para>The first thing to do is to adjust the linker. For this we retained the
+<?dbhtml filename="readjusting.html" dir="chapter06"?>
+
+<para>Now that the new and final C libraries have been installed, it's time to
+adjust our toolchain again. We'll adjust it so that it will link any newly
+compiled program against these new libraries. This is in fact the same we did
+in the "Adjusting" phase in the beginning of the previous chapter, even though
+it looks like the reverse: then we guided the chain from the host's
+<filename class="directory">{,/usr}/lib</filename> to the new
+<filename class="directory">/tools/lib</filename>, now we guide it from that
+same <filename class="directory">/tools/lib</filename>
+to the LFS's <filename class="directory">{,/usr}/lib</filename>.</para>
+
+<para>First we adjust the linker. For this we retained the
 source and build directories from the second pass over Binutils. Install the
 adjusted linker by running the following from within the
 <filename class="directory">binutils-build</filename> directory:</para>
@@ -378,10 +383,10 @@ source and build directories from the second pass in
 <xref linkend="chapter-temporary-tools"/>, or otherwise accidentally deleted them or just
 don't have access to them, don't worry, all is not lost. Just ignore the above
 command. The result will be that the next package, Binutils, will link against
-the Glibc libraries in <filename class="directory">/tools</filename> rather
-than <filename class="directory">/usr</filename>. This is not ideal, however,
-our testing has shown that the resulting Binutils program binaries should be
-identical.</para></note>
+the C libraries in <filename class="directory">/tools</filename> rather
+than <filename class="directory">{,/usr}/lib</filename>. This is not ideal,
+however, our testing has shown that the resulting Binutils program binaries
+should be identical.</para></note>
 
 <para>From now on every compiled program will link <emphasis>only</emphasis>
 against the libraries in <filename>/usr/lib</filename> and

chapter06/gcc.xml

@@ -90,7 +90,7 @@ compiler. To satisfy those packages, create a symlink:</para>
 
 <note><para>At this point it is strongly recommended to repeat the sanity check
 we performed earlier in this chapter. Refer back to
-<xref linkend="ch-system-adjustingtoolchain"/> and repeat the check. If the results
+<xref linkend="ch-system-readjusting"/> and repeat the check. If the results
 are wrong, then most likely you erroneously applied the GCC Specs patch from
 <xref linkend="chapter-temporary-tools"/>.</para></note>