aboutsummaryrefslogtreecommitdiffstats
path: root/chapter05
diff options
context:
space:
mode:
Diffstat (limited to 'chapter05')
-rw-r--r--chapter05/binutils-pass1.xml8
-rw-r--r--chapter05/binutils-pass2.xml8
-rw-r--r--chapter05/chapter05.xml24
-rw-r--r--chapter05/gcc-pass2.xml4
4 files changed, 21 insertions, 23 deletions
diff --git a/chapter05/binutils-pass1.xml b/chapter05/binutils-pass1.xml
index 34883a596..25cc593f4 100644
--- a/chapter05/binutils-pass1.xml
+++ b/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>
diff --git a/chapter05/binutils-pass2.xml b/chapter05/binutils-pass2.xml
index e696c986b..b77e9dac5 100644
--- a/chapter05/binutils-pass2.xml
+++ b/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>
diff --git a/chapter05/chapter05.xml b/chapter05/chapter05.xml
index 8e5699990..870c02ba6 100644
--- a/chapter05/chapter05.xml
+++ b/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>
diff --git a/chapter05/gcc-pass2.xml b/chapter05/gcc-pass2.xml
index cc7a66822..34bc6f63a 100644
--- a/chapter05/gcc-pass2.xml
+++ b/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>