From 50e693d738db6a9f7765a293c77cc85e4218739f Mon Sep 17 00:00:00 2001 From: Manuel Canales Esparcia Date: Tue, 31 Jan 2006 20:17:20 +0000 Subject: [PATCH] Started chapter06 indentation. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7323 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter06/aboutdebug.xml | 77 ++++---- chapter06/autoconf.xml | 252 ++++++++++++++----------- chapter06/automake.xml | 399 ++++++++++++++++++++++----------------- 3 files changed, 410 insertions(+), 318 deletions(-) diff --git a/chapter06/aboutdebug.xml b/chapter06/aboutdebug.xml index 5ba986652..5cecada9c 100644 --- a/chapter06/aboutdebug.xml +++ b/chapter06/aboutdebug.xml @@ -1,50 +1,53 @@ - %general-entities; ]> + -About Debugging Symbols - + -Most programs and libraries are, by default, compiled with -debugging symbols included (with gcc's --g 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. + About Debugging Symbols -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: - - + Most programs and libraries are, by default, compiled with + debugging symbols included (with gcc's + -g 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. -a bash binary -with debugging symbols: 1200 KB + 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: -a bash binary -without debugging symbols: 480 KB + + + A bash binary with debugging symbols: + 1200 KB + + + A bash binary without debugging symbols: + 480 KB + + + Glibc and GCC files (/lib + and /usr/lib) with debugging + symbols: 87 MB + + + Glibc and GCC files without debugging symbols: 16 MB + + -Glibc and GCC files (/lib -and /usr/lib) -with debugging symbols: 87 MB + 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. -Glibc and GCC files -without debugging symbols: 16 MB - - - -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. - -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 . + 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 + . - diff --git a/chapter06/autoconf.xml b/chapter06/autoconf.xml index 4067d02d0..77dc301c7 100644 --- a/chapter06/autoconf.xml +++ b/chapter06/autoconf.xml @@ -1,143 +1,177 @@ - %general-entities; ]> + -Autoconf-&autoconf-version; - + -Autoconf + Autoconf-&autoconf-version; - -<para>The Autoconf package contains programs for producing shell scripts that -can automatically configure source code.</para> + <indexterm zone="ch-system-autoconf"> + <primary sortas="a-Autoconf">Autoconf</primary> + </indexterm> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.5 SBU</seg><seg>8.5 MB</seg></seglistitem> -</segmentedlist> + <sect2 role="package"> + <title/> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Coreutils, Diffutils, Grep, -M4, Make, Perl, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <para>The Autoconf package contains programs for producing shell scripts that + can automatically configure source code.</para> -<sect2 role="installation"> -<title>Installation of Autoconf + + &buildtime; + &diskspace; -Prepare Autoconf for compilation: + + 0.5 SBU + 8.5 MB + + + + + &dependencies; + + + Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, and Sed + + + + + + + Installation of Autoconf + + Prepare Autoconf for compilation: ./configure --prefix=/usr -Compile the package: + Compile the package: make -To test the results, issue: -make check. This takes a long time, about 2 SBUs. + To test the results, issue: + make check. + This takes a long time, about 2 SBUs. -Install the package: + Install the package: make install - + -Contents of Autoconf + + Contents of Autoconf - -Installed programs -autoconf, autoheader, autom4te, -autoreconf, autoscan, autoupdate, and ifnames - + + Installed programs -Short Descriptions - - + + autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate, + and ifnames + + - -autoconf - -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—running them does not require the autoconf program. -autoconf - - + + Short Descriptions + + - -autoheader - -A tool for creating template files of C -#define statements for configure to use -autoheader - - + + autoconf + + 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—running + them does not require the autoconf program. + + autoconf + + + - -autom4te - -A wrapper for the M4 macro processor -autom4te - - + + autoheader + + A tool for creating template files of C + #define statements for configure to use + + autoheader + + + - -autoreconf - -Automatically runs autoconf, -autoheader, aclocal, -automake, gettextize, and -libtoolize in the correct order to save time -when changes are made to autoconf and -automake template files -autoreconf - - + + autom4te + + A wrapper for the M4 macro processor + + autom4te + + + - -autoscan - -Helps to create a configure.in file for a -software package; it examines the source files in a directory tree, -searching them for common portability issues, and creates a -configure.scan file that serves as as a -preliminary configure.in file for the -package -autoscan - - + + autoreconf + + Automatically runs autoconf, + autoheader, aclocal, + automake, gettextize, and + libtoolize in the correct order to save time + when changes are made to autoconf and + automake template files + + autoreconf + + + - -autoupdate - -Modifies a configure.in file that still -calls autoconf macros by their old names to use the -current macro names -autoupdate - - + + autoscan + + Helps to create a configure.in file for a + software package; it examines the source files in a directory tree, + searching them for common portability issues, and creates a + configure.scan file that serves as as a + preliminary configure.in file for the + package + + autoscan + + + - -ifnames - -Helps when writing configure.in files -for a software package; it prints the identifiers that the package -uses in C preprocessor conditionals. If a package has already been set -up to have some portability, this program can help determine what -configure needs to check for. It can also fill in -gaps in a configure.in file generated by -autoscan -ifnames - - - + + autoupdate + + Modifies a configure.in file that still + calls autoconf macros by their old names to use the + current macro names + + autoupdate + + + - + + ifnames + + Helps when writing configure.in files + for a software package; it prints the identifiers that the package + uses in C preprocessor conditionals. If a package has already been set + up to have some portability, this program can help determine what + configure needs to check for. It can also fill in + gaps in a configure.in file generated by + autoscan + + ifnames + + + + + + + - diff --git a/chapter06/automake.xml b/chapter06/automake.xml index 71350a2db..884776983 100644 --- a/chapter06/automake.xml +++ b/chapter06/automake.xml @@ -1,217 +1,272 @@ - %general-entities; ]> + -Automake-&automake-version; - + -Automake + Automake-&automake-version; - -<para>The Automake package contains programs for generating Makefiles for use -with Autoconf.</para> + <indexterm zone="ch-system-automake"> + <primary sortas="a-Automake">Automake</primary> + </indexterm> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem> -</segmentedlist> + <sect2 role="package"> + <title/> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Autoconf, Bash, Coreutils, -Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <para>The Automake package contains programs for generating Makefiles for use + with Autoconf.</para> -<sect2 role="installation"> -<title>Installation of Automake + + &buildtime; + &diskspace; -Prepare Automake for compilation: + + 0.2 SBU + 8.8 MB + + + + + &dependencies; + + + Autoconf, Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, + and Sed + + + + + + + Installation of Automake + + Prepare Automake for compilation: ./configure --prefix=/usr -Compile the package: + Compile the package: make -To test the results, issue: -make check. This takes a long time, about 5 SBUs. + To test the results, issue: + make check. + This takes a long time, about 5 SBUs. -Install the package: + Install the package: make install - + -Contents of Automake + + Contents of Automake - -Installed programs -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 - + + Installed programs -Short Descriptions - - + + 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 + + - -acinstall - -A script that installs aclocal-style M4 files -acinstall - - + + Short Descriptions + + - -aclocal - -Generates aclocal.m4 -files based on the contents of configure.in files -aclocal - - + + acinstall + + A script that installs aclocal-style M4 files + + acinstall + + + - -aclocal-&automake-version; - -A hard link to aclocal -aclocal-&automake-version; - - + + aclocal + + Generates aclocal.m4 files based on the + contents of configure.in files + + aclocal + + + - -automake - -A tool for automatically generating -Makefile.in files from -Makefile.am files. To create all the -Makefile.in files for a package, run this program -in the top-level directory. By scanning the -configure.in file, it automatically finds each -appropriate Makefile.am file and generates the -corresponding Makefile.in file -automake - - + + aclocal-&automake-version; + + A hard link to aclocal + + aclocal-&automake-version; + + + - -automake-&automake-version; - -A hard link to automake -automake-&automake-version; - - + + automake + + A tool for automatically generating + Makefile.in files from + Makefile.am files. To create all the + Makefile.in files for a package, run this program + in the top-level directory. By scanning the + configure.in file, it automatically finds each + appropriate Makefile.am file and generates the + corresponding Makefile.in file + + automake + + + - -compile - -A wrapper for compilers -compile - - + + automake-&automake-version; + + A hard link to automake + + automake-&automake-version; + + + - -config.guess - -A script that attempts to guess -the canonical triplet for the given build, host, or target architecture -config.guess - - + + compile + + A wrapper for compilers + + compile + + + - -config.sub - -A configuration validation subroutine script -config.sub - - + + config.guess + + A script that attempts to guess the canonical triplet for + the given build, host, or target architecture + + config.guess + + + - -depcomp - -A script for compiling a program so that dependency information -is generated in addition to the desired output -depcomp - - + + config.sub + + A configuration validation subroutine script + + config.sub + + + - -elisp-comp - -Byte-compiles Emacs Lisp code -elisp-comp - - + + depcomp + + A script for compiling a program so that dependency information + is generated in addition to the desired output + + depcomp + + + - -install-sh - -A script that installs a program, script, or data file -install-sh - - + + elisp-comp + + Byte-compiles Emacs Lisp code + + elisp-comp + + + - -mdate-sh - -A script that prints the modification time of a file or directory -mdate-sh - - + + install-sh + + A script that installs a program, script, or data file + + install-sh + + + - -missing - -A script acting as a common stub for missing GNU programs during -an installation -missing - - + + mdate-sh + + A script that prints the modification time of a file or + directory + + mdate-sh + + + - -mkinstalldirs - -A script that creates a directory tree -mkinstalldirs - - + + missing + + A script acting as a common stub for missing GNU programs during + an installation + + missing + + + - -py-compile - -Compiles a Python program -py-compile - - + + mkinstalldirs + + A script that creates a directory tree + + mkinstalldirs + + + - -symlink-tree - -A script to create a symlink tree of a directory tree -symlink-tree - - + + py-compile + + Compiles a Python program + + py-compile + + + - -ylwrap - -A wrapper for lex and yacc -ylwrap - - - + + symlink-tree + + A script to create a symlink tree of a directory tree + + symlink-tree + + + - + + ylwrap + + A wrapper for lex and + yacc + + ylwrap + + + + + + + -