r801 - in trunk/BOOK: . final-system final-system/common final-system/mips64 final-system/multilib introduction/common

jim at linuxfromscratch.org jim at linuxfromscratch.org
Fri Dec 2 08:36:40 PST 2005


Author: jim
Date: 2005-12-02 09:36:39 -0700 (Fri, 02 Dec 2005)
New Revision: 801

Added:
   trunk/BOOK/final-system/mips64/aboutdebug.xml
   trunk/BOOK/final-system/mips64/stripping.xml
   trunk/BOOK/final-system/multilib/aboutdebug.xml
   trunk/BOOK/final-system/multilib/stripping.xml
Modified:
   trunk/BOOK/
   trunk/BOOK/final-system/common/aboutdebug.xml
   trunk/BOOK/final-system/common/shadow.xml
   trunk/BOOK/final-system/common/stripping.xml
   trunk/BOOK/final-system/mips64-chapter.xml
   trunk/BOOK/final-system/multilib/perl-64bit.xml
   trunk/BOOK/final-system/sparc64-chapter.xml
   trunk/BOOK/final-system/x86_64-chapter.xml
   trunk/BOOK/introduction/common/acknowledgements.xml
Log:
 r880 at server:  jim | 2005-12-02 08:36:09 -0800
 Text Updates from G. Moko



Property changes on: trunk/BOOK
___________________________________________________________________
Name: svk:merge
   - 3949c430-d905-0410-97b6-f115d20341b5:/cross-lfs:879
f6929928-7304-0410-9559-ff6106abff4d:/cross-lfs:790
   + 3949c430-d905-0410-97b6-f115d20341b5:/cross-lfs:880
f6929928-7304-0410-9559-ff6106abff4d:/cross-lfs:790

Modified: trunk/BOOK/final-system/common/aboutdebug.xml
===================================================================
--- trunk/BOOK/final-system/common/aboutdebug.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/common/aboutdebug.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -10,38 +10,38 @@
 
   <title>About Debugging Symbols</title>
 
-  <para>Most programs and libraries are, by default, compiled with debugging
+  <para os="a">Most programs and libraries are, by default, compiled with debugging
   symbols included (with <command>gcc</command>'s <option>-g</option> option).
   This means that when debugging a program or library that was compiled with
   debugging information included, the debugger can provide not only memory
   addresses, but also the names of the routines and variables.</para>
 
-  <para>However, the inclusion of these debugging symbols enlarges a
+  <para os="b">However, the inclusion of these debugging symbols enlarges a
   program or library significantly. The following is an example of the
   amount of space these symbols occupy:</para>
 
-  <itemizedlist>
-    <listitem>
+  <itemizedlist os="c">
+    <listitem os="c1">
       <para>a bash binary with debugging symbols: 1200 KB</para>
     </listitem>
-    <listitem>
+    <listitem os="c2">
       <para>a bash binary without debugging symbols: 480 KB</para>
     </listitem>
-    <listitem>
+    <listitem os="c3">
       <para>Glibc and GCC files (<filename class="directory">/lib</filename>
       and <filename class="directory">/usr/lib</filename>) with debugging
       symbols: 87 MB</para>
     </listitem>
-    <listitem>
+    <listitem os="c4">
       <para>Glibc and GCC files without debugging symbols: 16 MB</para>
     </listitem>
   </itemizedlist>
 
-  <para>Sizes may vary depending on which compiler and C library were used,
+  <para os="d">Sizes may vary depending on which compiler and C library were used,
   but when comparing programs with and without debugging symbols, the
   difference will usually be a factor between two and five.</para>
 
-  <para>Because most users will never use a debugger on their system software,
+  <para os="e">Because most users will never use a debugger on their system software,
   a lot of disk space can be regained by removing these symbols. The next
   section shows how to strip all debugging symbols from the programs and
   libraries. Additional information on system optimization can be found at

Modified: trunk/BOOK/final-system/common/shadow.xml
===================================================================
--- trunk/BOOK/final-system/common/shadow.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/common/shadow.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -104,7 +104,7 @@
     -e 's@/var/spool/mail@/var/mail@' \
     etc/login.defs > /etc/login.defs</userinput></screen>
 
-    <para os="r">Move a misplaced program to their proper location:</para>
+    <para os="r">Move a misplaced program to its proper location:</para>
 
 <screen os="s"><userinput>mv /usr/bin/passwd /bin</userinput></screen>
 

Modified: trunk/BOOK/final-system/common/stripping.xml
===================================================================
--- trunk/BOOK/final-system/common/stripping.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/common/stripping.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -10,44 +10,44 @@
 
   <title>Stripping</title>
 
-  <para>If the intended user is not a programmer and does not plan to do
+  <para os="a">If the intended user is not a programmer and does not plan to do
   any debugging on the system software, the system size can be decreased
   by about 200 MB by removing the debugging symbols from binaries and
   libraries. This causes no inconvenience other than not being able to
   debug the software fully anymore.</para>
 
-  <para>Most people who use the command mentioned below do not
+  <para os="b">Most people who use the command mentioned below do not
   experience any difficulties. However, it is easy to make a typo and
   render the new system unusable, so before running the
   <command>strip</command> command, it is a good idea to make a
   backup of the current situation.</para>
 
-  <para>Before performing the stripping, take special care to ensure that
+  <para os="c">Before performing the stripping, take special care to ensure that
   none of the binaries that are about to be stripped are running. If
   unsure whether the user entered chroot with the command given in
   <xref linkend="chapter-chroot" role=","/> first exit from
   chroot:</para>
 
-<screen><userinput>logout</userinput></screen>
+<screen os="d"><userinput>logout</userinput></screen>
 
-    <para>Then reenter it with:</para>
+    <para os="e">Then reenter it with:</para>
 
-<screen><userinput>chroot $LFS /tools/bin/env -i \
+<screen os="f"><userinput>chroot $LFS /tools/bin/env -i \
     HOME=/root TERM=$TERM PS1='\u:\w\$ ' \
     PATH=/bin:/usr/bin:/sbin:/usr/sbin \
     /tools/bin/bash --login</userinput></screen>
 
-    <para>Now the binaries and libraries can be safely stripped:</para>
+    <para os="g">Now the binaries and libraries can be safely stripped:</para>
 
-<screen><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
+<screen os="h"><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
    -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>
 
-    <para>A large number of files will be reported as having their file
+    <para os="i">A large number of files will be reported as having their file
     format not recognized. These warnings can be safely ignored. These
     warnings indicate that those files are scripts instead of
     binaries.</para>
 
-    <para>If disk space is very tight, the <option>--strip-all</option>
+    <para os="j">If disk space is very tight, the <option>--strip-all</option>
     option can be used on the binaries in <filename
     class="directory">/{,usr/}{bin,sbin}</filename> to gain several more
     megabytes. Do not use this option on libraries—they will be

Added: trunk/BOOK/final-system/mips64/aboutdebug.xml
===================================================================
--- trunk/BOOK/final-system/mips64/aboutdebug.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/mips64/aboutdebug.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="ch-system-aboutdebug">
+  <?dbhtml filename="aboutdebug.html"?>
+
+  <title>About Debugging Symbols</title>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='a'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='b'])"/>
+
+  <itemizedlist os="c">
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c1'])"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c2'])"/>
+
+    <listitem os="c3">
+      <para>Glibc and GCC files (<filename class="directory">/lib</filename>,
+      (<filename class="directory">/lib32,</filename>,
+      (<filename class="directory">/lib64,</filename>,
+      (<filename class="directory">/usr/lib</filename>,
+      (<filename class="directory">/usr/lib32</filename>,
+      and <filename class="directory">/usr/lib64</filename>) with debugging
+      symbols: 87 MB</para>
+    </listitem>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c4'])"/>
+
+  </itemizedlist>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='d'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='e'])"/>
+
+</sect1>

Added: trunk/BOOK/final-system/mips64/stripping.xml
===================================================================
--- trunk/BOOK/final-system/mips64/stripping.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/mips64/stripping.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="ch-system-stripping">
+  <?dbhtml filename="stripping.html"?>
+
+  <title>Stripping</title>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='a'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='b'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='c'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='d'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='e'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='f'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='g'])"/>
+
+<screen os="h"><userinput>/tools/bin/find /{,usr/}{bin,lib,lib32,lib64,sbin} -type f \
+   -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='i'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='j'])"/>
+
+</sect1>

Modified: trunk/BOOK/final-system/mips64-chapter.xml
===================================================================
--- trunk/BOOK/final-system/mips64-chapter.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/mips64-chapter.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -89,7 +89,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/colo.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/dvhtool.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/arcload.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/aboutdebug.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips64/stripping.xml"/>
 
 </chapter>

Added: trunk/BOOK/final-system/multilib/aboutdebug.xml
===================================================================
--- trunk/BOOK/final-system/multilib/aboutdebug.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/multilib/aboutdebug.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="ch-system-aboutdebug">
+  <?dbhtml filename="aboutdebug.html"?>
+
+  <title>About Debugging Symbols</title>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='a'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='b'])"/>
+
+  <itemizedlist os="c">
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c1'])"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c2'])"/>
+
+    <listitem os="c3">
+      <para>Glibc and GCC files (<filename class="directory">/lib</filename>,
+      (<filename class="directory">/lib64,</filename>,
+      (<filename class="directory">/usr/lib</filename>,
+      and <filename class="directory">/usr/lib64</filename>) with debugging
+      symbols: 87 MB</para>
+    </listitem>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/aboutdebug.xml"
+    xpointer="xpointer(//*[@os='c4'])"/>
+
+  </itemizedlist>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='d'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/aboutdebug.xml"
+  xpointer="xpointer(//*[@os='e'])"/>
+
+</sect1>

Modified: trunk/BOOK/final-system/multilib/perl-64bit.xml
===================================================================
--- trunk/BOOK/final-system/multilib/perl-64bit.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/multilib/perl-64bit.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -98,6 +98,10 @@
     href="../common/perl.xml"
     xpointer="xpointer(//*[@os='j'])"/>
 
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../common/perl.xml"
+    xpointer="xpointer(//*[@os='k'])"/>
+
   </sect2>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"

Added: trunk/BOOK/final-system/multilib/stripping.xml
===================================================================
--- trunk/BOOK/final-system/multilib/stripping.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/multilib/stripping.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="ch-system-stripping">
+  <?dbhtml filename="stripping.html"?>
+
+  <title>Stripping</title>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='a'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='b'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='c'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='d'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='e'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='f'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='g'])"/>
+
+<screen os="h"><userinput>/tools/bin/find /{,usr/}{bin,lib,lib64,sbin} -type f \
+   -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='i'])"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+  href="../common/stripping.xml"
+  xpointer="xpointer(//*[@os='j'])"/>
+
+</sect1>

Modified: trunk/BOOK/final-system/sparc64-chapter.xml
===================================================================
--- trunk/BOOK/final-system/sparc64-chapter.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/sparc64-chapter.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -76,7 +76,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/hotplug.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sparc64/elftoaout.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sparc64/silo.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/aboutdebug.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/stripping.xml"/>
 
 </chapter>

Modified: trunk/BOOK/final-system/x86_64-chapter.xml
===================================================================
--- trunk/BOOK/final-system/x86_64-chapter.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/final-system/x86_64-chapter.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -75,7 +75,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/mktemp.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/hotplug.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x86_64/grub.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/aboutdebug.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/stripping.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/aboutdebug.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="multilib/stripping.xml"/>
 
 </chapter>

Modified: trunk/BOOK/introduction/common/acknowledgements.xml
===================================================================
--- trunk/BOOK/introduction/common/acknowledgements.xml	2005-12-02 16:36:31 UTC (rev 800)
+++ trunk/BOOK/introduction/common/acknowledgements.xml	2005-12-02 16:36:39 UTC (rev 801)
@@ -56,6 +56,9 @@
     <listitem>
       <para>Alexander E. Patrakov - Udev/Hotplug Integration</para>
     </listitem>
+    <listitem>
+      <para>G. Moko - Text updates and Typos</para>
+    </listitem>
   </itemizedlist>
 
   <para>Thank you all for your support.</para>




More information about the cross-lfs mailing list