rewrote bash install page

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2306 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Gerard Beekmans 2003-01-11 16:18:59 +00:00
parent e8fe4dcb00
commit 1bbb24b645
7 changed files with 55 additions and 37 deletions

View File

@ -1,13 +1,8 @@
<sect2><title>Contents of Binutils</title>
<sect2><title>Descriptions</title>
<para>Last checked against version &binutils-contversion;.</para>
<sect3><title>Program Files</title>
<para>addr2line, ar, as, gprof, ld, nm, objcopy, objdump,
ranlib, readelf, size, strings and strip</para></sect3>
<sect3><title>Descriptions</title>
<sect3><title>Program files descriptions</title>
<sect4><title>addr2line</title>
<para>addr2line translates program addresses into file names and line numbers.
@ -79,10 +74,7 @@ modified copies under different names.</para></sect4>
</sect3>
<sect3><title>Library Files</title>
<para>libbfd.[a,so] and libopcodes.[a,so]</para></sect3>
<sect3><title>Descriptions</title>
<sect3><title>Library files descriptions</title>
<sect4><title>libbfd</title>
<para>libbfd is the Binary File Descriptor library.</para></sect4>

View File

@ -0,0 +1,20 @@
<sect2><title>Contents of Binutils</title>
<para>Last checked against version &binutils-contversion;.</para>
<para>Binutils is a collection of software development tools containing a
linker, assembler and other tools to work with object files and
archives.</para>
<para>Binutils installs the following files:</para>
<sect3><title>Program Files</title>
<para>addr2line, ar, as, gprof, ld, nm, objcopy, objdump,
ranlib, readelf, size, strings and strip</para></sect3>
<sect3><title>Library Files</title>
<para>libbfd.[a,so] and libopcodes.[a,so]</para></sect3>
</sect2>

View File

@ -3,6 +3,7 @@
<?dbhtml filename="binutils.html" dir="appendixa"?>
&aa-binutils-down;
&aa-binutils-shortdesc;
&aa-binutils-desc;
&aa-binutils-dep;

View File

@ -1,18 +0,0 @@
<sect2>
<title>Command explanations</title>
<para><userinput>mkdir ../binutils-build:</userinput> The installation
instructions for Binutils recommend creating a separate build directory
instead of compiling the package inside the source tree. So, we create a
binutils-build directory and work from there.</para>
<para><userinput>--disable-nls:</userinput> This option disables
internationalization (also known as i18n). We don't need this for our
static programs and nls often causes problems when you're linking
statically.</para>
<para><userinput>LDFLAGS="-all-static":</userinput> Setting the variable LDFLAGS
to the value -all-static causes binutils to be linked statically.</para>
</sect2>

View File

@ -8,14 +8,37 @@ that override default optimizations, such as CFLAGS and CXXFLAGS, we
recommend unsetting or modifying them when building binutils. You have been
warned.</para>
<para>Install Binutils by running the following commands:</para>
<para>It is recommended by the Binutils installation documentation to build
Binutils outside of the source directory in a dedicated directory:</para>
<para><screen><userinput>mkdir ../binutils-build
cd ../binutils-build</userinput></screen></para>
<para><screen><userinput>mkdir ../binutils-build &amp;&amp;
cd ../binutils-build &amp;&amp;
../binutils-&binutils-version;/configure --prefix=$LFS/static --disable-nls &amp;&amp;
make LDFLAGS="-all-static" &amp;&amp;
<para>Next, prepare Binutils to be compiled:</para>
<para><screen><userinput>../binutils-&binutils-version;/configure --prefix=$LFS/static --disable-nls</userinput></screen></para>
<para>The meaning of the (new) configure switches are:</para>
<itemizedlist>
<listitem><para><userinput>--disable-nls:</userinput> This option disables
internationalization (also known as i18n). We don't need this for our
static programs and nls often causes problems when you're linking
statically.</para></listitem>
</itemizedlist>
<para>We'll finish off by compiling and installing the package:</para>
<para><screen><userinput>make LDFLAGS="-all-static" &amp;&amp;
make install</userinput></screen></para>
<para><emphasis>make LDFLAGS="-all-static"</emphasis> is how we tell
Binutils that all programs should be statically linked. Setting the
<emphasis>LDFLAGS</emphasis> variable is the common way of specifying we
want a static link to take place, however, its value and the way it is set
is not always the same. You'll see with the remaining packages that there
are different ways of setting up the <emphasis>LDFLAGS</emphasis>
variable.</para>
</sect2>

View File

@ -5,10 +5,9 @@
<screen>Estimated build time: &binutils-time-static;
Estimated required disk space: &binutils-compsize-static;</screen>
&c5-binutils-inst;
&c5-binutils-exp;
&aa-binutils-desc;
&aa-binutils-shortdesc;
&aa-binutils-dep;
&c5-binutils-inst;
</sect1>

View File

@ -9,6 +9,7 @@
<!ENTITY c6-binutils-exp SYSTEM "../chapter06/binutils-exp.xml">
<!ENTITY aa-binutils SYSTEM "../appendixa/binutils.xml">
<!ENTITY aa-binutils-shortdesc SYSTEM "../appendixa/binutils-shortdesc.xml">
<!ENTITY aa-binutils-desc SYSTEM "../appendixa/binutils-desc.xml">
<!ENTITY aa-binutils-dep SYSTEM "../appendixa/binutils-dep.xml">
<!ENTITY aa-binutils-down SYSTEM "../appendixa/binutils-down.xml">