mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-07-16 17:25:08 +01:00
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
parent
c4dfdaaafc
commit
50e693d738
@ -1,50 +1,53 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?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">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<sect1 id="ch-system-aboutdebug">
|
<sect1 id="ch-system-aboutdebug">
|
||||||
<title>About Debugging Symbols</title>
|
<?dbhtml filename="aboutdebug.html"?>
|
||||||
<?dbhtml filename="aboutdebug.html"?>
|
|
||||||
|
|
||||||
<para>Most programs and libraries are, by default, compiled with
|
<title>About Debugging Symbols</title>
|
||||||
debugging symbols included (with <command>gcc</command>'s
|
|
||||||
<parameter>-g</parameter> 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>Most programs and libraries are, by default, compiled with
|
||||||
program or library significantly. The following is an example of the
|
debugging symbols included (with <command>gcc</command>'s
|
||||||
amount of space these symbols occupy:</para>
|
<parameter>-g</parameter> 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>
|
||||||
|
|
||||||
<itemizedlist>
|
<para>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>
|
||||||
|
|
||||||
<listitem><para>a bash binary
|
<itemizedlist>
|
||||||
with debugging symbols: 1200 KB</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>
|
||||||
|
|
||||||
<listitem><para>a bash binary
|
<para>Sizes may vary depending on which compiler and C library were used,
|
||||||
without debugging symbols: 480 KB</para></listitem>
|
but when comparing programs with and without debugging symbols, the
|
||||||
|
difference will usually be a factor between two and five.</para>
|
||||||
|
|
||||||
<listitem><para>Glibc and GCC files (<filename class="directory">/lib</filename>
|
<para>Because most users will never use a debugger on their system software,
|
||||||
and <filename class="directory">/usr/lib</filename>)
|
a lot of disk space can be regained by removing these symbols. The next
|
||||||
with debugging symbols: 87 MB</para></listitem>
|
section shows how to strip all debugging symbols from the programs and
|
||||||
|
libraries. Additional information on system optimization can be found at
|
||||||
<listitem><para>Glibc and GCC files
|
<ulink url="&hints-root;optimization.txt"/>.</para>
|
||||||
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>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>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
@ -1,143 +1,177 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?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">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<sect1 id="ch-system-autoconf" role="wrap">
|
<sect1 id="ch-system-autoconf" role="wrap">
|
||||||
<title>Autoconf-&autoconf-version;</title>
|
<?dbhtml filename="autoconf.html"?>
|
||||||
<?dbhtml filename="autoconf.html"?>
|
|
||||||
|
|
||||||
<indexterm zone="ch-system-autoconf"><primary sortas="a-Autoconf">Autoconf</primary></indexterm>
|
<title>Autoconf-&autoconf-version;</title>
|
||||||
|
|
||||||
<sect2 role="package"><title/>
|
<indexterm zone="ch-system-autoconf">
|
||||||
<para>The Autoconf package contains programs for producing shell scripts that
|
<primary sortas="a-Autoconf">Autoconf</primary>
|
||||||
can automatically configure source code.</para>
|
</indexterm>
|
||||||
|
|
||||||
<segmentedlist>
|
<sect2 role="package">
|
||||||
<segtitle>&buildtime;</segtitle>
|
<title/>
|
||||||
<segtitle>&diskspace;</segtitle>
|
|
||||||
<seglistitem><seg>0.5 SBU</seg><seg>8.5 MB</seg></seglistitem>
|
|
||||||
</segmentedlist>
|
|
||||||
|
|
||||||
<segmentedlist>
|
<para>The Autoconf package contains programs for producing shell scripts that
|
||||||
<segtitle>&dependencies;</segtitle>
|
can automatically configure source code.</para>
|
||||||
<seglistitem><seg>Bash, Coreutils, Diffutils, Grep,
|
|
||||||
M4, Make, Perl, and Sed</seg></seglistitem>
|
|
||||||
</segmentedlist>
|
|
||||||
</sect2>
|
|
||||||
|
|
||||||
<sect2 role="installation">
|
<segmentedlist>
|
||||||
<title>Installation of Autoconf</title>
|
<segtitle>&buildtime;</segtitle>
|
||||||
|
<segtitle>&diskspace;</segtitle>
|
||||||
|
|
||||||
<para>Prepare Autoconf for compilation:</para>
|
<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>
|
||||||
|
</segmentedlist>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 role="installation">
|
||||||
|
<title>Installation of Autoconf</title>
|
||||||
|
|
||||||
|
<para>Prepare Autoconf for compilation:</para>
|
||||||
|
|
||||||
<screen><userinput>./configure --prefix=/usr</userinput></screen>
|
<screen><userinput>./configure --prefix=/usr</userinput></screen>
|
||||||
|
|
||||||
<para>Compile the package:</para>
|
<para>Compile the package:</para>
|
||||||
|
|
||||||
<screen><userinput>make</userinput></screen>
|
<screen><userinput>make</userinput></screen>
|
||||||
|
|
||||||
<para>To test the results, issue:
|
<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>
|
<para>Install the package:</para>
|
||||||
|
|
||||||
<screen><userinput>make install</userinput></screen>
|
<screen><userinput>make install</userinput></screen>
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="contents-autoconf" role="content"><title>Contents of Autoconf</title>
|
<sect2 id="contents-autoconf" role="content">
|
||||||
|
<title>Contents of Autoconf</title>
|
||||||
|
|
||||||
<segmentedlist>
|
<segmentedlist>
|
||||||
<segtitle>Installed programs</segtitle>
|
<segtitle>Installed programs</segtitle>
|
||||||
<seglistitem><seg>autoconf, autoheader, autom4te,
|
|
||||||
autoreconf, autoscan, autoupdate, and ifnames</seg></seglistitem>
|
|
||||||
</segmentedlist>
|
|
||||||
|
|
||||||
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
<seglistitem>
|
||||||
<?dbfo list-presentation="list"?>
|
<seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
|
||||||
<?dbhtml list-presentation="table"?>
|
and ifnames</seg>
|
||||||
|
</seglistitem>
|
||||||
|
</segmentedlist>
|
||||||
|
|
||||||
<varlistentry id="autoconf">
|
<variablelist>
|
||||||
<term><command>autoconf</command></term>
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||||
<listitem>
|
<?dbfo list-presentation="list"?>
|
||||||
<para>Produces shell scripts that automatically
|
<?dbhtml list-presentation="table"?>
|
||||||
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 <command>autoconf</command> program.</para>
|
|
||||||
<indexterm zone="ch-system-autoconf autoconf"><primary sortas="b-autoconf">autoconf</primary></indexterm>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry id="autoheader">
|
<varlistentry id="autoconf">
|
||||||
<term><command>autoheader</command> </term>
|
<term><command>autoconf</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A tool for creating template files of C
|
<para>Produces shell scripts that automatically configure software
|
||||||
<emphasis>#define</emphasis> statements for configure to use</para>
|
source code packages to adapt to many kinds of Unix-like systems.
|
||||||
<indexterm zone="ch-system-autoconf autoheader"><primary sortas="b-autoheader">autoheader</primary></indexterm>
|
The configuration scripts it produces are independent—running
|
||||||
</listitem>
|
them does not require the <command>autoconf</command> program.</para>
|
||||||
</varlistentry>
|
<indexterm zone="ch-system-autoconf autoconf">
|
||||||
|
<primary sortas="b-autoconf">autoconf</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="autom4te">
|
<varlistentry id="autoheader">
|
||||||
<term><command>autom4te</command></term>
|
<term><command>autoheader</command> </term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A wrapper for the M4 macro processor</para>
|
<para>A tool for creating template files of C
|
||||||
<indexterm zone="ch-system-autoconf autom4te"><primary sortas="b-autom4te">autom4te</primary></indexterm>
|
<emphasis>#define</emphasis> statements for configure to use</para>
|
||||||
</listitem>
|
<indexterm zone="ch-system-autoconf autoheader">
|
||||||
</varlistentry>
|
<primary sortas="b-autoheader">autoheader</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="autoreconf">
|
<varlistentry id="autom4te">
|
||||||
<term><command>autoreconf</command></term>
|
<term><command>autom4te</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Automatically runs <command>autoconf</command>,
|
<para>A wrapper for the M4 macro processor</para>
|
||||||
<command>autoheader</command>, <command>aclocal</command>,
|
<indexterm zone="ch-system-autoconf autom4te">
|
||||||
<command>automake</command>, <command>gettextize</command>, and
|
<primary sortas="b-autom4te">autom4te</primary>
|
||||||
<command>libtoolize</command> in the correct order to save time
|
</indexterm>
|
||||||
when changes are made to <command>autoconf</command> and
|
</listitem>
|
||||||
<command>automake</command> template files</para>
|
</varlistentry>
|
||||||
<indexterm zone="ch-system-autoconf autoreconf"><primary sortas="b-autoreconf">autoreconf</primary></indexterm>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry id="autoscan">
|
<varlistentry id="autoreconf">
|
||||||
<term><command>autoscan</command> </term>
|
<term><command>autoreconf</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Helps to create a <filename>configure.in</filename> file for a
|
<para>Automatically runs <command>autoconf</command>,
|
||||||
software package; it examines the source files in a directory tree,
|
<command>autoheader</command>, <command>aclocal</command>,
|
||||||
searching them for common portability issues, and creates a
|
<command>automake</command>, <command>gettextize</command>, and
|
||||||
<filename>configure.scan</filename> file that serves as as a
|
<command>libtoolize</command> in the correct order to save time
|
||||||
preliminary <filename>configure.in</filename> file for the
|
when changes are made to <command>autoconf</command> and
|
||||||
package</para>
|
<command>automake</command> template files</para>
|
||||||
<indexterm zone="ch-system-autoconf autoscan"><primary sortas="b-autoscan">autoscan</primary></indexterm>
|
<indexterm zone="ch-system-autoconf autoreconf">
|
||||||
</listitem>
|
<primary sortas="b-autoreconf">autoreconf</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="autoupdate">
|
<varlistentry id="autoscan">
|
||||||
<term><command>autoupdate</command></term>
|
<term><command>autoscan</command> </term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Modifies a <filename>configure.in</filename> file that still
|
<para>Helps to create a <filename>configure.in</filename> file for a
|
||||||
calls <command>autoconf</command> macros by their old names to use the
|
software package; it examines the source files in a directory tree,
|
||||||
current macro names</para>
|
searching them for common portability issues, and creates a
|
||||||
<indexterm zone="ch-system-autoconf autoupdate"><primary sortas="b-autoupdate">autoupdate</primary></indexterm>
|
<filename>configure.scan</filename> file that serves as as a
|
||||||
</listitem>
|
preliminary <filename>configure.in</filename> file for the
|
||||||
</varlistentry>
|
package</para>
|
||||||
|
<indexterm zone="ch-system-autoconf autoscan">
|
||||||
|
<primary sortas="b-autoscan">autoscan</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="ifnames">
|
<varlistentry id="autoupdate">
|
||||||
<term><command>ifnames</command> </term>
|
<term><command>autoupdate</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Helps when writing <filename>configure.in</filename> files
|
<para>Modifies a <filename>configure.in</filename> file that still
|
||||||
for a software package; it prints the identifiers that the package
|
calls <command>autoconf</command> macros by their old names to use the
|
||||||
uses in C preprocessor conditionals. If a package has already been set
|
current macro names</para>
|
||||||
up to have some portability, this program can help determine what
|
<indexterm zone="ch-system-autoconf autoupdate">
|
||||||
<command>configure</command> needs to check for. It can also fill in
|
<primary sortas="b-autoupdate">autoupdate</primary>
|
||||||
gaps in a <filename>configure.in</filename> file generated by
|
</indexterm>
|
||||||
<command>autoscan</command></para>
|
</listitem>
|
||||||
<indexterm zone="ch-system-autoconf ifnames"><primary sortas="b-ifnames">ifnames</primary></indexterm>
|
</varlistentry>
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
</variablelist>
|
|
||||||
|
|
||||||
</sect2>
|
<varlistentry id="ifnames">
|
||||||
|
<term><command>ifnames</command> </term>
|
||||||
|
<listitem>
|
||||||
|
<para>Helps when writing <filename>configure.in</filename> 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
|
||||||
|
<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>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
</variablelist>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
@ -1,217 +1,272 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?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">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<sect1 id="ch-system-automake" role="wrap">
|
<sect1 id="ch-system-automake" role="wrap">
|
||||||
<title>Automake-&automake-version;</title>
|
<?dbhtml filename="automake.html"?>
|
||||||
<?dbhtml filename="automake.html"?>
|
|
||||||
|
|
||||||
<indexterm zone="ch-system-automake"><primary sortas="a-Automake">Automake</primary></indexterm>
|
<title>Automake-&automake-version;</title>
|
||||||
|
|
||||||
<sect2 role="package"><title/>
|
<indexterm zone="ch-system-automake">
|
||||||
<para>The Automake package contains programs for generating Makefiles for use
|
<primary sortas="a-Automake">Automake</primary>
|
||||||
with Autoconf.</para>
|
</indexterm>
|
||||||
|
|
||||||
<segmentedlist>
|
<sect2 role="package">
|
||||||
<segtitle>&buildtime;</segtitle>
|
<title/>
|
||||||
<segtitle>&diskspace;</segtitle>
|
|
||||||
<seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem>
|
|
||||||
</segmentedlist>
|
|
||||||
|
|
||||||
<segmentedlist>
|
<para>The Automake package contains programs for generating Makefiles for use
|
||||||
<segtitle>&dependencies;</segtitle>
|
with Autoconf.</para>
|
||||||
<seglistitem><seg>Autoconf, Bash, Coreutils,
|
|
||||||
Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem>
|
|
||||||
</segmentedlist>
|
|
||||||
</sect2>
|
|
||||||
|
|
||||||
<sect2 role="installation">
|
<segmentedlist>
|
||||||
<title>Installation of Automake</title>
|
<segtitle>&buildtime;</segtitle>
|
||||||
|
<segtitle>&diskspace;</segtitle>
|
||||||
|
|
||||||
<para>Prepare Automake for compilation:</para>
|
<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>
|
||||||
|
</segmentedlist>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 role="installation">
|
||||||
|
<title>Installation of Automake</title>
|
||||||
|
|
||||||
|
<para>Prepare Automake for compilation:</para>
|
||||||
|
|
||||||
<screen><userinput>./configure --prefix=/usr</userinput></screen>
|
<screen><userinput>./configure --prefix=/usr</userinput></screen>
|
||||||
|
|
||||||
<para>Compile the package:</para>
|
<para>Compile the package:</para>
|
||||||
|
|
||||||
<screen><userinput>make</userinput></screen>
|
<screen><userinput>make</userinput></screen>
|
||||||
|
|
||||||
<para>To test the results, issue:
|
<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>
|
<para>Install the package:</para>
|
||||||
|
|
||||||
<screen><userinput>make install</userinput></screen>
|
<screen><userinput>make install</userinput></screen>
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
|
||||||
<sect2 id="contents-automake" role="content"><title>Contents of Automake</title>
|
<sect2 id="contents-automake" role="content">
|
||||||
|
<title>Contents of Automake</title>
|
||||||
|
|
||||||
<segmentedlist>
|
<segmentedlist>
|
||||||
<segtitle>Installed programs</segtitle>
|
<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>
|
|
||||||
</segmentedlist>
|
|
||||||
|
|
||||||
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
<seglistitem>
|
||||||
<?dbfo list-presentation="list"?>
|
<seg>acinstall, aclocal, aclocal-&automake-version;, automake,
|
||||||
<?dbhtml list-presentation="table"?>
|
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>
|
||||||
|
|
||||||
<varlistentry id="acinstall">
|
<variablelist>
|
||||||
<term><command>acinstall</command></term>
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||||
<listitem>
|
<?dbfo list-presentation="list"?>
|
||||||
<para>A script that installs aclocal-style M4 files</para>
|
<?dbhtml list-presentation="table"?>
|
||||||
<indexterm zone="ch-system-automake acinstall"><primary sortas="b-acinstall">acinstall</primary></indexterm>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry id="aclocal">
|
<varlistentry id="acinstall">
|
||||||
<term><command>aclocal</command></term>
|
<term><command>acinstall</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Generates <filename>aclocal.m4</filename>
|
<para>A script that installs aclocal-style M4 files</para>
|
||||||
files based on the contents of <filename>configure.in</filename> files</para>
|
<indexterm zone="ch-system-automake acinstall">
|
||||||
<indexterm zone="ch-system-automake aclocal"><primary sortas="b-aclocal">aclocal</primary></indexterm>
|
<primary sortas="b-acinstall">acinstall</primary>
|
||||||
</listitem>
|
</indexterm>
|
||||||
</varlistentry>
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="aclocal-version">
|
<varlistentry id="aclocal">
|
||||||
<term><command>aclocal-&automake-version;</command></term>
|
<term><command>aclocal</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A hard link to <command>aclocal</command></para>
|
<para>Generates <filename>aclocal.m4</filename> files based on the
|
||||||
<indexterm zone="ch-system-automake aclocal-version"><primary
|
contents of <filename>configure.in</filename> files</para>
|
||||||
sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary></indexterm>
|
<indexterm zone="ch-system-automake aclocal">
|
||||||
</listitem>
|
<primary sortas="b-aclocal">aclocal</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="automake">
|
<varlistentry id="aclocal-version">
|
||||||
<term><command>automake</command></term>
|
<term><command>aclocal-&automake-version;</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A tool for automatically generating
|
<para>A hard link to <command>aclocal</command></para>
|
||||||
<filename>Makefile.in</filename> files from
|
<indexterm zone="ch-system-automake aclocal-version">
|
||||||
<filename>Makefile.am</filename> files. To create all the
|
<primary sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary>
|
||||||
<filename>Makefile.in</filename> files for a package, run this program
|
</indexterm>
|
||||||
in the top-level directory. By scanning the
|
</listitem>
|
||||||
<filename>configure.in</filename> file, it automatically finds each
|
</varlistentry>
|
||||||
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>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry id="automake-version">
|
<varlistentry id="automake">
|
||||||
<term><command>automake-&automake-version;</command></term>
|
<term><command>automake</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A hard link to <command>automake</command></para>
|
<para>A tool for automatically generating
|
||||||
<indexterm zone="ch-system-automake automake-version"><primary
|
<filename>Makefile.in</filename> files from
|
||||||
sortas="b-automake-&automake-version;">automake-&automake-version;</primary></indexterm>
|
<filename>Makefile.am</filename> files. To create all the
|
||||||
</listitem>
|
<filename>Makefile.in</filename> files for a package, run this program
|
||||||
</varlistentry>
|
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>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="compile">
|
<varlistentry id="automake-version">
|
||||||
<term><command>compile</command></term>
|
<term><command>automake-&automake-version;</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A wrapper for compilers</para>
|
<para>A hard link to <command>automake</command></para>
|
||||||
<indexterm zone="ch-system-automake compile"><primary sortas="b-compile">compile</primary></indexterm>
|
<indexterm zone="ch-system-automake automake-version">
|
||||||
</listitem>
|
<primary sortas="b-automake-&automake-version;">automake-&automake-version;</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="config.guess">
|
<varlistentry id="compile">
|
||||||
<term><command>config.guess</command></term>
|
<term><command>compile</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script that attempts to guess
|
<para>A wrapper for compilers</para>
|
||||||
the canonical triplet for the given build, host, or target architecture</para>
|
<indexterm zone="ch-system-automake compile">
|
||||||
<indexterm zone="ch-system-automake config.guess"><primary sortas="b-config.guess">config.guess</primary></indexterm>
|
<primary sortas="b-compile">compile</primary>
|
||||||
</listitem>
|
</indexterm>
|
||||||
</varlistentry>
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="config.sub">
|
<varlistentry id="config.guess">
|
||||||
<term><command>config.sub</command></term>
|
<term><command>config.guess</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A configuration validation subroutine script</para>
|
<para>A script that attempts to guess the canonical triplet for
|
||||||
<indexterm zone="ch-system-automake config.sub"><primary sortas="b-config.sub">config.sub</primary></indexterm>
|
the given build, host, or target architecture</para>
|
||||||
</listitem>
|
<indexterm zone="ch-system-automake config.guess">
|
||||||
</varlistentry>
|
<primary sortas="b-config.guess">config.guess</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="depcomp">
|
<varlistentry id="config.sub">
|
||||||
<term><command>depcomp</command></term>
|
<term><command>config.sub</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script for compiling a program so that dependency information
|
<para>A configuration validation subroutine script</para>
|
||||||
is generated in addition to the desired output</para>
|
<indexterm zone="ch-system-automake config.sub">
|
||||||
<indexterm zone="ch-system-automake depcomp"><primary sortas="b-depcomp">depcomp</primary></indexterm>
|
<primary sortas="b-config.sub">config.sub</primary>
|
||||||
</listitem>
|
</indexterm>
|
||||||
</varlistentry>
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="elisp-comp">
|
<varlistentry id="depcomp">
|
||||||
<term><command>elisp-comp</command></term>
|
<term><command>depcomp</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Byte-compiles Emacs Lisp code</para>
|
<para>A script for compiling a program so that dependency information
|
||||||
<indexterm zone="ch-system-automake elisp-comp"><primary sortas="b-elisp-comp">elisp-comp</primary></indexterm>
|
is generated in addition to the desired output</para>
|
||||||
</listitem>
|
<indexterm zone="ch-system-automake depcomp">
|
||||||
</varlistentry>
|
<primary sortas="b-depcomp">depcomp</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="install-sh">
|
<varlistentry id="elisp-comp">
|
||||||
<term><command>install-sh</command></term>
|
<term><command>elisp-comp</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script that installs a program, script, or data file</para>
|
<para>Byte-compiles Emacs Lisp code</para>
|
||||||
<indexterm zone="ch-system-automake install-sh"><primary sortas="b-install-sh">install-sh</primary></indexterm>
|
<indexterm zone="ch-system-automake elisp-comp">
|
||||||
</listitem>
|
<primary sortas="b-elisp-comp">elisp-comp</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="mdate-sh">
|
<varlistentry id="install-sh">
|
||||||
<term><command>mdate-sh</command></term>
|
<term><command>install-sh</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script that prints the modification time of a file or directory</para>
|
<para>A script that installs a program, script, or data file</para>
|
||||||
<indexterm zone="ch-system-automake mdate-sh"><primary sortas="b-mdate-sh">mdate-sh</primary></indexterm>
|
<indexterm zone="ch-system-automake install-sh">
|
||||||
</listitem>
|
<primary sortas="b-install-sh">install-sh</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="missing">
|
<varlistentry id="mdate-sh">
|
||||||
<term><command>missing</command></term>
|
<term><command>mdate-sh</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script acting as a common stub for missing GNU programs during
|
<para>A script that prints the modification time of a file or
|
||||||
an installation</para>
|
directory</para>
|
||||||
<indexterm zone="ch-system-automake missing"><primary sortas="b-missing">missing</primary></indexterm>
|
<indexterm zone="ch-system-automake mdate-sh">
|
||||||
</listitem>
|
<primary sortas="b-mdate-sh">mdate-sh</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="mkinstalldirs">
|
<varlistentry id="missing">
|
||||||
<term><command>mkinstalldirs</command></term>
|
<term><command>missing</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script that creates a directory tree</para>
|
<para>A script acting as a common stub for missing GNU programs during
|
||||||
<indexterm zone="ch-system-automake mkinstalldirs"><primary sortas="b-mkinstalldirs">mkinstalldirs</primary></indexterm>
|
an installation</para>
|
||||||
</listitem>
|
<indexterm zone="ch-system-automake missing">
|
||||||
</varlistentry>
|
<primary sortas="b-missing">missing</primary>
|
||||||
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="py-compile">
|
<varlistentry id="mkinstalldirs">
|
||||||
<term><command>py-compile</command></term>
|
<term><command>mkinstalldirs</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Compiles a Python program</para>
|
<para>A script that creates a directory tree</para>
|
||||||
<indexterm zone="ch-system-automake py-compile"><primary sortas="b-py-compile">py-compile</primary></indexterm>
|
<indexterm zone="ch-system-automake mkinstalldirs">
|
||||||
</listitem>
|
<primary sortas="b-mkinstalldirs">mkinstalldirs</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="symlink-tree">
|
<varlistentry id="py-compile">
|
||||||
<term><command>symlink-tree</command></term>
|
<term><command>py-compile</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A script to create a symlink tree of a directory tree</para>
|
<para>Compiles a Python program</para>
|
||||||
<indexterm zone="ch-system-automake symlink-tree"><primary sortas="b-symlink-tree">symlink-tree</primary></indexterm>
|
<indexterm zone="ch-system-automake py-compile">
|
||||||
</listitem>
|
<primary sortas="b-py-compile">py-compile</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry id="ylwrap">
|
<varlistentry id="symlink-tree">
|
||||||
<term><command>ylwrap</command></term>
|
<term><command>symlink-tree</command></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>A wrapper for <command>lex</command> and <command>yacc</command></para>
|
<para>A script to create a symlink tree of a directory tree</para>
|
||||||
<indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm>
|
<indexterm zone="ch-system-automake symlink-tree">
|
||||||
</listitem>
|
<primary sortas="b-symlink-tree">symlink-tree</primary>
|
||||||
</varlistentry>
|
</indexterm>
|
||||||
</variablelist>
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
</sect2>
|
<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>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
</variablelist>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user