cvs commit: LFS/BOOK/entities binutils.ent

gerard at linuxfromscratch.org gerard at linuxfromscratch.org
Sat Jan 11 08:18:59 PST 2003


gerard      03/01/11 11:18:59

  Modified:    BOOK/appendixa binutils-desc.xml binutils.xml
               BOOK/chapter05 binutils-inst.xml binutils.xml
               BOOK/entities binutils.ent
  Added:       BOOK/appendixa binutils-shortdesc.xml
  Removed:     BOOK/chapter05 binutils-exp.xml
  Log:
  rewrote bash install page
  
  Revision  Changes    Path
  1.17      +3 -11     LFS/BOOK/appendixa/binutils-desc.xml
  
  Index: binutils-desc.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/appendixa/binutils-desc.xml,v
  retrieving revision 1.16
  retrieving revision 1.17
  diff -u -r1.16 -r1.17
  --- binutils-desc.xml	31 Dec 2002 21:10:12 -0000	1.16
  +++ binutils-desc.xml	11 Jan 2003 16:18:59 -0000	1.17
  @@ -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 @@
   
   </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>
  
  
  
  1.5       +1 -0      LFS/BOOK/appendixa/binutils.xml
  
  Index: binutils.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/appendixa/binutils.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- binutils.xml	15 Dec 2001 14:28:34 -0000	1.4
  +++ binutils.xml	11 Jan 2003 16:18:59 -0000	1.5
  @@ -3,6 +3,7 @@
   <?dbhtml filename="binutils.html" dir="appendixa"?>
   
   &aa-binutils-down;
  +&aa-binutils-shortdesc;
   &aa-binutils-desc;
   &aa-binutils-dep;
   
  
  
  
  1.1                  LFS/BOOK/appendixa/binutils-shortdesc.xml
  
  Index: binutils-shortdesc.xml
  ===================================================================
  <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>
  
  
  
  
  1.16      +28 -5     LFS/BOOK/chapter05/binutils-inst.xml
  
  Index: binutils-inst.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter05/binutils-inst.xml,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- binutils-inst.xml	30 Dec 2002 03:12:45 -0000	1.15
  +++ binutils-inst.xml	11 Jan 2003 16:18:59 -0000	1.16
  @@ -8,14 +8,37 @@
   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 &&
  -cd ../binutils-build &&
  -../binutils-&binutils-version;/configure --prefix=$LFS/static --disable-nls &&
  -make LDFLAGS="-all-static" &&
  +<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" &&
   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>
   
  
  
  
  1.9       +2 -3      LFS/BOOK/chapter05/binutils.xml
  
  Index: binutils.xml
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/chapter05/binutils.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- binutils.xml	14 Dec 2001 23:04:46 -0000	1.8
  +++ binutils.xml	11 Jan 2003 16:18:59 -0000	1.9
  @@ -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>
   
  
  
  
  1.13      +1 -0      LFS/BOOK/entities/binutils.ent
  
  Index: binutils.ent
  ===================================================================
  RCS file: /home/cvsroot/LFS/BOOK/entities/binutils.ent,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- binutils.ent	6 Jan 2003 20:44:06 -0000	1.12
  +++ binutils.ent	11 Jan 2003 16:18:59 -0000	1.13
  @@ -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">
  
  
  
-- 
Unsubscribe: send email to listar at linuxfromscratch.org
and put 'unsubscribe lfs-book' in the subject header of the message



More information about the lfs-book mailing list