Started chapter06 indentation.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7323 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-01-31 20:17:20 +00:00
parent c4dfdaaafc
commit 50e693d738
3 changed files with 410 additions and 318 deletions

View File

@ -1,12 +1,15 @@
<?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" [
<!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">
<title>About Debugging Symbols</title>
<?dbhtml filename="aboutdebug.html"?>
<title>About Debugging Symbols</title>
<para>Most programs and libraries are, by default, compiled with
debugging symbols included (with <command>gcc</command>'s
<parameter>-g</parameter> option). This means that when debugging a
@ -19,32 +22,32 @@ program or library significantly. The following is an example of the
amount of space these symbols occupy:</para>
<itemizedlist>
<listitem><para>a bash binary
with debugging symbols: 1200 KB</para></listitem>
<listitem><para>a bash binary
without debugging symbols: 480 KB</para></listitem>
<listitem><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><para>Glibc and GCC files
without debugging symbols: 16 MB</para></listitem>
<listitem>
<para>A <command>bash</command> binary with debugging symbols:
1200 KB</para>
</listitem>
<listitem>
<para>A <command>bash</command> binary without debugging symbols:
480 KB</para>
</listitem>
<listitem>
<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>
<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, but when comparing programs with and without debugging
symbols, the difference will usually be a factor between two and
five.</para>
<para>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, 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 <ulink url="&hints-root;optimization.txt"/>.</para>
<para>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
<ulink url="&hints-root;optimization.txt"/>.</para>
</sect1>

View File

@ -1,29 +1,43 @@
<?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" [
<!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-autoconf" role="wrap">
<title>Autoconf-&autoconf-version;</title>
<?dbhtml filename="autoconf.html"?>
<indexterm zone="ch-system-autoconf"><primary sortas="a-Autoconf">Autoconf</primary></indexterm>
<title>Autoconf-&autoconf-version;</title>
<indexterm zone="ch-system-autoconf">
<primary sortas="a-Autoconf">Autoconf</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Autoconf package contains programs for producing shell scripts that
can automatically configure source code.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.5 SBU</seg><seg>8.5 MB</seg></seglistitem>
<seglistitem>
<seg>0.5 SBU</seg>
<seg>8.5 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Coreutils, Diffutils, Grep,
M4, Make, Perl, and Sed</seg></seglistitem>
<seglistitem>
<seg>Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
@ -38,7 +52,8 @@ M4, Make, Perl, and Sed</seg></seglistitem>
<screen><userinput>make</userinput></screen>
<para>To test the results, issue:
<userinput>make check</userinput>. This takes a long time, about 2 SBUs.</para>
<userinput>make check</userinput>.
This takes a long time, about 2 SBUs.</para>
<para>Install the package:</para>
@ -46,26 +61,33 @@ M4, Make, Perl, and Sed</seg></seglistitem>
</sect2>
<sect2 id="contents-autoconf" role="content"><title>Contents of Autoconf</title>
<sect2 id="contents-autoconf" role="content">
<title>Contents of Autoconf</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>autoconf, autoheader, autom4te,
autoreconf, autoscan, autoupdate, and ifnames</seg></seglistitem>
<seglistitem>
<seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
and ifnames</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="autoconf">
<term><command>autoconf</command></term>
<listitem>
<para>Produces shell scripts that automatically
configure software source code packages to adapt to many kinds of
Unix-like systems. The configuration scripts it produces are
independent&mdash;running them does not require the <command>autoconf</command> program.</para>
<indexterm zone="ch-system-autoconf autoconf"><primary sortas="b-autoconf">autoconf</primary></indexterm>
<para>Produces shell scripts that automatically configure software
source code packages to adapt to many kinds of Unix-like systems.
The configuration scripts it produces are independent&mdash;running
them does not require the <command>autoconf</command> program.</para>
<indexterm zone="ch-system-autoconf autoconf">
<primary sortas="b-autoconf">autoconf</primary>
</indexterm>
</listitem>
</varlistentry>
@ -74,7 +96,9 @@ independent&mdash;running them does not require the <command>autoconf</command>
<listitem>
<para>A tool for creating template files of C
<emphasis>#define</emphasis> statements for configure to use</para>
<indexterm zone="ch-system-autoconf autoheader"><primary sortas="b-autoheader">autoheader</primary></indexterm>
<indexterm zone="ch-system-autoconf autoheader">
<primary sortas="b-autoheader">autoheader</primary>
</indexterm>
</listitem>
</varlistentry>
@ -82,7 +106,9 @@ independent&mdash;running them does not require the <command>autoconf</command>
<term><command>autom4te</command></term>
<listitem>
<para>A wrapper for the M4 macro processor</para>
<indexterm zone="ch-system-autoconf autom4te"><primary sortas="b-autom4te">autom4te</primary></indexterm>
<indexterm zone="ch-system-autoconf autom4te">
<primary sortas="b-autom4te">autom4te</primary>
</indexterm>
</listitem>
</varlistentry>
@ -95,7 +121,9 @@ independent&mdash;running them does not require the <command>autoconf</command>
<command>libtoolize</command> in the correct order to save time
when changes are made to <command>autoconf</command> and
<command>automake</command> template files</para>
<indexterm zone="ch-system-autoconf autoreconf"><primary sortas="b-autoreconf">autoreconf</primary></indexterm>
<indexterm zone="ch-system-autoconf autoreconf">
<primary sortas="b-autoreconf">autoreconf</primary>
</indexterm>
</listitem>
</varlistentry>
@ -108,7 +136,9 @@ searching them for common portability issues, and creates a
<filename>configure.scan</filename> file that serves as as a
preliminary <filename>configure.in</filename> file for the
package</para>
<indexterm zone="ch-system-autoconf autoscan"><primary sortas="b-autoscan">autoscan</primary></indexterm>
<indexterm zone="ch-system-autoconf autoscan">
<primary sortas="b-autoscan">autoscan</primary>
</indexterm>
</listitem>
</varlistentry>
@ -118,7 +148,9 @@ package</para>
<para>Modifies a <filename>configure.in</filename> file that still
calls <command>autoconf</command> macros by their old names to use the
current macro names</para>
<indexterm zone="ch-system-autoconf autoupdate"><primary sortas="b-autoupdate">autoupdate</primary></indexterm>
<indexterm zone="ch-system-autoconf autoupdate">
<primary sortas="b-autoupdate">autoupdate</primary>
</indexterm>
</listitem>
</varlistentry>
@ -132,12 +164,14 @@ up to have some portability, this program can help determine what
<command>configure</command> needs to check for. It can also fill in
gaps in a <filename>configure.in</filename> file generated by
<command>autoscan</command></para>
<indexterm zone="ch-system-autoconf ifnames"><primary sortas="b-ifnames">ifnames</primary></indexterm>
<indexterm zone="ch-system-autoconf ifnames">
<primary sortas="b-ifnames">ifnames</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -1,29 +1,44 @@
<?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" [
<!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-automake" role="wrap">
<title>Automake-&automake-version;</title>
<?dbhtml filename="automake.html"?>
<indexterm zone="ch-system-automake"><primary sortas="a-Automake">Automake</primary></indexterm>
<title>Automake-&automake-version;</title>
<indexterm zone="ch-system-automake">
<primary sortas="a-Automake">Automake</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Automake package contains programs for generating Makefiles for use
with Autoconf.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem>
<seglistitem>
<seg>0.2 SBU</seg>
<seg>8.8 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Autoconf, Bash, Coreutils,
Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem>
<seglistitem>
<seg>Autoconf, Bash, Coreutils, Diffutils, Grep, M4, Make, Perl,
and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
@ -38,7 +53,8 @@ Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem>
<screen><userinput>make</userinput></screen>
<para>To test the results, issue:
<userinput>make check</userinput>. This takes a long time, about 5 SBUs.</para>
<userinput>make check</userinput>.
This takes a long time, about 5 SBUs.</para>
<para>Install the package:</para>
@ -47,17 +63,22 @@ Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem>
</sect2>
<sect2 id="contents-automake" role="content"><title>Contents of Automake</title>
<sect2 id="contents-automake" role="content">
<title>Contents of Automake</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>acinstall, aclocal, aclocal-&automake-version;,
automake, automake-&automake-version;,
compile, config.guess, config.sub, depcomp, elisp-comp, install-sh, mdate-sh,
missing, mkinstalldirs, py-compile, symlink-tree, and ylwrap</seg></seglistitem>
<seglistitem>
<seg>acinstall, aclocal, aclocal-&automake-version;, automake,
automake-&automake-version;, compile, config.guess, config.sub,
depcomp, elisp-comp, install-sh, mdate-sh, missing, mkinstalldirs,
py-compile, symlink-tree, and ylwrap</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -65,16 +86,20 @@ missing, mkinstalldirs, py-compile, symlink-tree, and ylwrap</seg></seglistitem>
<term><command>acinstall</command></term>
<listitem>
<para>A script that installs aclocal-style M4 files</para>
<indexterm zone="ch-system-automake acinstall"><primary sortas="b-acinstall">acinstall</primary></indexterm>
<indexterm zone="ch-system-automake acinstall">
<primary sortas="b-acinstall">acinstall</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="aclocal">
<term><command>aclocal</command></term>
<listitem>
<para>Generates <filename>aclocal.m4</filename>
files based on the contents of <filename>configure.in</filename> files</para>
<indexterm zone="ch-system-automake aclocal"><primary sortas="b-aclocal">aclocal</primary></indexterm>
<para>Generates <filename>aclocal.m4</filename> files based on the
contents of <filename>configure.in</filename> files</para>
<indexterm zone="ch-system-automake aclocal">
<primary sortas="b-aclocal">aclocal</primary>
</indexterm>
</listitem>
</varlistentry>
@ -82,8 +107,9 @@ files based on the contents of <filename>configure.in</filename> files</para>
<term><command>aclocal-&automake-version;</command></term>
<listitem>
<para>A hard link to <command>aclocal</command></para>
<indexterm zone="ch-system-automake aclocal-version"><primary
sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary></indexterm>
<indexterm zone="ch-system-automake aclocal-version">
<primary sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary>
</indexterm>
</listitem>
</varlistentry>
@ -98,7 +124,9 @@ in the top-level directory. By scanning the
<filename>configure.in</filename> file, it automatically finds each
appropriate <filename>Makefile.am</filename> file and generates the
corresponding <filename>Makefile.in</filename> file</para>
<indexterm zone="ch-system-automake automake"><primary sortas="b-automake">automake</primary></indexterm>
<indexterm zone="ch-system-automake automake">
<primary sortas="b-automake">automake</primary>
</indexterm>
</listitem>
</varlistentry>
@ -106,8 +134,9 @@ corresponding <filename>Makefile.in</filename> file</para>
<term><command>automake-&automake-version;</command></term>
<listitem>
<para>A hard link to <command>automake</command></para>
<indexterm zone="ch-system-automake automake-version"><primary
sortas="b-automake-&automake-version;">automake-&automake-version;</primary></indexterm>
<indexterm zone="ch-system-automake automake-version">
<primary sortas="b-automake-&automake-version;">automake-&automake-version;</primary>
</indexterm>
</listitem>
</varlistentry>
@ -115,16 +144,20 @@ sortas="b-automake-&automake-version;">automake-&automake-version;</primary></in
<term><command>compile</command></term>
<listitem>
<para>A wrapper for compilers</para>
<indexterm zone="ch-system-automake compile"><primary sortas="b-compile">compile</primary></indexterm>
<indexterm zone="ch-system-automake compile">
<primary sortas="b-compile">compile</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="config.guess">
<term><command>config.guess</command></term>
<listitem>
<para>A script that attempts to guess
the canonical triplet for the given build, host, or target architecture</para>
<indexterm zone="ch-system-automake config.guess"><primary sortas="b-config.guess">config.guess</primary></indexterm>
<para>A script that attempts to guess the canonical triplet for
the given build, host, or target architecture</para>
<indexterm zone="ch-system-automake config.guess">
<primary sortas="b-config.guess">config.guess</primary>
</indexterm>
</listitem>
</varlistentry>
@ -132,7 +165,9 @@ the canonical triplet for the given build, host, or target architecture</para>
<term><command>config.sub</command></term>
<listitem>
<para>A configuration validation subroutine script</para>
<indexterm zone="ch-system-automake config.sub"><primary sortas="b-config.sub">config.sub</primary></indexterm>
<indexterm zone="ch-system-automake config.sub">
<primary sortas="b-config.sub">config.sub</primary>
</indexterm>
</listitem>
</varlistentry>
@ -141,7 +176,9 @@ the canonical triplet for the given build, host, or target architecture</para>
<listitem>
<para>A script for compiling a program so that dependency information
is generated in addition to the desired output</para>
<indexterm zone="ch-system-automake depcomp"><primary sortas="b-depcomp">depcomp</primary></indexterm>
<indexterm zone="ch-system-automake depcomp">
<primary sortas="b-depcomp">depcomp</primary>
</indexterm>
</listitem>
</varlistentry>
@ -149,7 +186,9 @@ is generated in addition to the desired output</para>
<term><command>elisp-comp</command></term>
<listitem>
<para>Byte-compiles Emacs Lisp code</para>
<indexterm zone="ch-system-automake elisp-comp"><primary sortas="b-elisp-comp">elisp-comp</primary></indexterm>
<indexterm zone="ch-system-automake elisp-comp">
<primary sortas="b-elisp-comp">elisp-comp</primary>
</indexterm>
</listitem>
</varlistentry>
@ -157,15 +196,20 @@ is generated in addition to the desired output</para>
<term><command>install-sh</command></term>
<listitem>
<para>A script that installs a program, script, or data file</para>
<indexterm zone="ch-system-automake install-sh"><primary sortas="b-install-sh">install-sh</primary></indexterm>
<indexterm zone="ch-system-automake install-sh">
<primary sortas="b-install-sh">install-sh</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mdate-sh">
<term><command>mdate-sh</command></term>
<listitem>
<para>A script that prints the modification time of a file or directory</para>
<indexterm zone="ch-system-automake mdate-sh"><primary sortas="b-mdate-sh">mdate-sh</primary></indexterm>
<para>A script that prints the modification time of a file or
directory</para>
<indexterm zone="ch-system-automake mdate-sh">
<primary sortas="b-mdate-sh">mdate-sh</primary>
</indexterm>
</listitem>
</varlistentry>
@ -174,7 +218,9 @@ is generated in addition to the desired output</para>
<listitem>
<para>A script acting as a common stub for missing GNU programs during
an installation</para>
<indexterm zone="ch-system-automake missing"><primary sortas="b-missing">missing</primary></indexterm>
<indexterm zone="ch-system-automake missing">
<primary sortas="b-missing">missing</primary>
</indexterm>
</listitem>
</varlistentry>
@ -182,7 +228,9 @@ an installation</para>
<term><command>mkinstalldirs</command></term>
<listitem>
<para>A script that creates a directory tree</para>
<indexterm zone="ch-system-automake mkinstalldirs"><primary sortas="b-mkinstalldirs">mkinstalldirs</primary></indexterm>
<indexterm zone="ch-system-automake mkinstalldirs">
<primary sortas="b-mkinstalldirs">mkinstalldirs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -190,7 +238,9 @@ an installation</para>
<term><command>py-compile</command></term>
<listitem>
<para>Compiles a Python program</para>
<indexterm zone="ch-system-automake py-compile"><primary sortas="b-py-compile">py-compile</primary></indexterm>
<indexterm zone="ch-system-automake py-compile">
<primary sortas="b-py-compile">py-compile</primary>
</indexterm>
</listitem>
</varlistentry>
@ -198,20 +248,25 @@ an installation</para>
<term><command>symlink-tree</command></term>
<listitem>
<para>A script to create a symlink tree of a directory tree</para>
<indexterm zone="ch-system-automake symlink-tree"><primary sortas="b-symlink-tree">symlink-tree</primary></indexterm>
<indexterm zone="ch-system-automake symlink-tree">
<primary sortas="b-symlink-tree">symlink-tree</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ylwrap">
<term><command>ylwrap</command></term>
<listitem>
<para>A wrapper for <command>lex</command> and <command>yacc</command></para>
<indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm>
<para>A wrapper for <command>lex</command> and
<command>yacc</command></para>
<indexterm zone="ch-system-automake ylwrap">
<primary sortas="b-ylwrap">ylwrap</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>