diff options
Diffstat (limited to 'chapter05/binutils-pass1.xml')
| -rw-r--r-- | chapter05/binutils-pass1.xml | 45 |
1 files changed, 24 insertions, 21 deletions
diff --git a/chapter05/binutils-pass1.xml b/chapter05/binutils-pass1.xml index 13eac6710..3b362c533 100644 --- a/chapter05/binutils-pass1.xml +++ b/chapter05/binutils-pass1.xml @@ -1,14 +1,23 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> <sect1 id="ch-tools-binutils-pass1"> -<title>Installing Binutils-&binutils-version; - Pass 1</title> -<?dbhtml filename="binutils-pass1.html" dir="chapter05"?> +<title>Binutils-&binutils-version; - Pass 1</title> +<?dbhtml filename="binutils-pass1.html"?> -<screen>&buildtime; &binutils-time-tools-pass1; -&diskspace; &binutils-compsize-tools-pass1;</screen> +<indexterm zone="ch-tools-binutils-pass1"> +<primary sortas="a-Binutils">Binutils</primary> +<secondary>tools, pass 1</secondary></indexterm> -&aa-binutils-down; -&aa-binutils-dep; +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[1])"/> + +<screen>&buildtime; 1.0 SBU +&diskspace; 194 MB</screen> + +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/binutils.xml" xpointer="xpointer(/sect1/para[2])"/> -<sect2><title> </title><para> </para></sect2> <sect2> <title>Installation of Binutils</title> @@ -21,7 +30,7 @@ assembler to determine which of their own features to enable.</para> optimization flags (including the <emphasis>-march</emphasis> and <emphasis>-mcpu</emphasis> options). Therefore, if you have defined any environment variables that override default optimizations, such as CFLAGS and -CXXFLAGS, we recommend unsetting them when building Binutils.</para> +CXXFLAGS, we recommend un-setting them when building Binutils.</para> <para>The Binutils documentation recommends building Binutils outside of the source directory in a dedicated build directory:</para> @@ -31,14 +40,14 @@ cd ../binutils-build</userinput></screen> <note><para>If you want the SBU values listed in the rest of the book to be of any use, you will have to measure the time it takes to build this package -- -from the configuration upto and including the first install. To achieve this +from the configuration up to and including the first install. To achieve this easily, you could wrap the four commands in a <command>time</command> command like this: <userinput>time { ./configure ... && ... && ... && make install; }</userinput>.</para></note> <para>Now prepare Binutils for compilation:</para> -<screen><userinput>../&binutils-dir;/configure --prefix=/tools --disable-nls</userinput></screen> +<screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools --disable-nls</userinput></screen> <para>The meaning of the configure options:</para> @@ -79,11 +88,11 @@ yet in place. And there would be little point in running the tests anyhow, since the programs from this first pass will soon be replaced by those from the second.</para> -<para>And install the package:</para> +<para>Now install the package:</para> <screen><userinput>make install</userinput></screen> -<para>Now prepare the linker for the "Adjusting" phase later on:</para> +<para>Now prepare the linker for the <quote>Adjusting</quote> phase later on:</para> <screen><userinput>make -C ld clean make -C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput></screen> @@ -92,8 +101,7 @@ make -C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput></screen> <itemizedlist> <listitem><para><userinput>-C ld clean</userinput>: This tells the make program -to remove all the compiled files in the <filename -class="directory">ld</filename> subdirectory.</para></listitem> +to remove all the compiled files in the <filename class="directory">ld</filename> subdirectory.</para></listitem> <listitem><para><userinput>-C ld LDFLAGS="-all-static" LIB_PATH=/tools/lib</userinput>: This option rebuilds everything in the @@ -104,21 +112,16 @@ specifies the linker's default library search path. You will see how this preparation is used later on in the chapter.</para></listitem> </itemizedlist> -<!-- HACK - Force some whitespace to appease tidy --> -<literallayout></literallayout> <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> </sect2> -<sect2><title> </title><para> </para> +<sect2><title> </title><para> </para> <para>The details on this package are found in <xref linkend="contents-binutils"/>.</para> -<para> </para></sect2> +<para> </para></sect2> </sect1> - |