Changeset 50e693d


Ignore:
Timestamp:
01/31/2006 08:17:20 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
92474b45
Parents:
c4dfdaaa
Message:

Started chapter06 indentation.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7323 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Location:
chapter06
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • chapter06/aboutdebug.xml

    rc4dfdaaa r50e693d  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-aboutdebug">
    7 <title>About Debugging Symbols</title>
    8 <?dbhtml filename="aboutdebug.html"?>
     9  <?dbhtml filename="aboutdebug.html"?>
    910
    10 <para>Most programs and libraries are, by default, compiled with
    11 debugging symbols included (with <command>gcc</command>'s
    12 <parameter>-g</parameter> option). This means that when debugging a
    13 program or library that was compiled with debugging information
    14 included, the debugger can provide not only memory addresses, but also
    15 the names of the routines and variables.</para>
     11  <title>About Debugging Symbols</title>
    1612
    17 <para>However, the inclusion of these debugging symbols enlarges a
    18 program or library significantly. The following is an example of the
    19 amount of space these symbols occupy:</para>
    20  
    21 <itemizedlist>
     13  <para>Most programs and libraries are, by default, compiled with
     14  debugging symbols included (with <command>gcc</command>'s
     15  <parameter>-g</parameter> option). This means that when debugging a
     16  program or library that was compiled with debugging information
     17  included, the debugger can provide not only memory addresses, but also
     18  the names of the routines and variables.</para>
    2219
    23 <listitem><para>a bash binary
    24 with debugging symbols: 1200 KB</para></listitem>
     20  <para>However, the inclusion of these debugging symbols enlarges a
     21  program or library significantly. The following is an example of the
     22  amount of space these symbols occupy:</para>
    2523
    26 <listitem><para>a bash binary
    27 without debugging symbols: 480 KB</para></listitem>
     24  <itemizedlist>
     25    <listitem>
     26      <para>A <command>bash</command> binary with debugging symbols:
     27      1200 KB</para>
     28    </listitem>
     29    <listitem>
     30      <para>A <command>bash</command> binary without debugging symbols:
     31      480 KB</para>
     32    </listitem>
     33    <listitem>
     34      <para>Glibc and GCC files (<filename class="directory">/lib</filename>
     35      and <filename class="directory">/usr/lib</filename>) with debugging
     36      symbols: 87 MB</para>
     37    </listitem>
     38    <listitem>
     39      <para>Glibc and GCC files without debugging symbols: 16 MB</para>
     40    </listitem>
     41  </itemizedlist>
    2842
    29 <listitem><para>Glibc and GCC files (<filename class="directory">/lib</filename>
    30 and <filename class="directory">/usr/lib</filename>)
    31 with debugging symbols: 87 MB</para></listitem>
     43  <para>Sizes may vary depending on which compiler and C library were used,
     44  but when comparing programs with and without debugging symbols, the
     45  difference will usually be a factor between two and five.</para>
    3246
    33 <listitem><para>Glibc and GCC files
    34 without debugging symbols: 16 MB</para></listitem>
    35 
    36 </itemizedlist>
    37 
    38 <para>Sizes may vary depending on which compiler and C
    39 library were used, but when comparing programs with and without debugging
    40 symbols, the difference will usually be a factor between two and
    41 five.</para>
    42 
    43 <para>Because most users will never use a debugger on their system
    44 software, a lot of disk space can be regained by removing these
    45 symbols. The next section shows how to strip all debugging symbols
    46 from the programs and libraries. Additional information on system
    47 optimization can be found at <ulink url="&hints-root;optimization.txt"/>.</para>
     47  <para>Because most users will never use a debugger on their system software,
     48  a lot of disk space can be regained by removing these symbols. The next
     49  section shows how to strip all debugging symbols from the programs and
     50  libraries. Additional information on system optimization can be found at
     51  <ulink url="&hints-root;optimization.txt"/>.</para>
    4852
    4953</sect1>
    50 

  • chapter06/autoconf.xml

    rc4dfdaaa r50e693d  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-autoconf" role="wrap">
    7 <title>Autoconf-&autoconf-version;</title>
    8 <?dbhtml filename="autoconf.html"?>
     9  <?dbhtml filename="autoconf.html"?>
    910
    10 <indexterm zone="ch-system-autoconf"><primary sortas="a-Autoconf">Autoconf</primary></indexterm>
     11  <title>Autoconf-&autoconf-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Autoconf package contains programs for producing shell scripts that
    14 can automatically configure source code.</para>
     13  <indexterm zone="ch-system-autoconf">
     14    <primary sortas="a-Autoconf">Autoconf</primary>
     15  </indexterm>
    1516
    16 <segmentedlist>
    17 <segtitle>&buildtime;</segtitle>
    18 <segtitle>&diskspace;</segtitle>
    19 <seglistitem><seg>0.5 SBU</seg><seg>8.5 MB</seg></seglistitem>
    20 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2119
    22 <segmentedlist>
    23 <segtitle>&dependencies;</segtitle>
    24 <seglistitem><seg>Bash, Coreutils, Diffutils, Grep,
    25 M4, Make, Perl, and Sed</seg></seglistitem>
    26 </segmentedlist>
    27 </sect2>
     20    <para>The Autoconf package contains programs for producing shell scripts that
     21    can automatically configure source code.</para>
    2822
    29 <sect2 role="installation">
    30 <title>Installation of Autoconf</title>
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
    3126
    32 <para>Prepare Autoconf for compilation:</para>
     27      <seglistitem>
     28        <seg>0.5 SBU</seg>
     29        <seg>8.5 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
     32
     33    <segmentedlist>
     34    <segtitle>&dependencies;</segtitle>
     35
     36      <seglistitem>
     37        <seg>Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, and Sed</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of Autoconf</title>
     45
     46    <para>Prepare Autoconf for compilation:</para>
    3347
    3448<screen><userinput>./configure --prefix=/usr</userinput></screen>
    3549
    36 <para>Compile the package:</para>
     50    <para>Compile the package:</para>
    3751
    3852<screen><userinput>make</userinput></screen>
    3953
    40 <para>To test the results, issue:
    41 <userinput>make check</userinput>. This takes a long time, about 2 SBUs.</para>
     54    <para>To test the results, issue:
     55    <userinput>make check</userinput>.
     56    This takes a long time, about 2 SBUs.</para>
    4257
    43 <para>Install the package:</para>
     58    <para>Install the package:</para>
    4459
    4560<screen><userinput>make install</userinput></screen>
    4661
    47 </sect2>
     62  </sect2>
    4863
    49 <sect2 id="contents-autoconf" role="content"><title>Contents of Autoconf</title>
     64  <sect2 id="contents-autoconf" role="content">
     65    <title>Contents of Autoconf</title>
    5066
    51 <segmentedlist>
    52 <segtitle>Installed programs</segtitle>
    53 <seglistitem><seg>autoconf, autoheader, autom4te,
    54 autoreconf, autoscan, autoupdate, and ifnames</seg></seglistitem>
    55 </segmentedlist>
     67    <segmentedlist>
     68      <segtitle>Installed programs</segtitle>
    5669
    57 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    58 <?dbfo list-presentation="list"?>
    59 <?dbhtml list-presentation="table"?>
     70      <seglistitem>
     71        <seg>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate,
     72        and ifnames</seg>
     73      </seglistitem>
     74    </segmentedlist>
    6075
    61 <varlistentry id="autoconf">
    62 <term><command>autoconf</command></term>
    63 <listitem>
    64 <para>Produces shell scripts that automatically
    65 configure software source code packages to adapt to many kinds of
    66 Unix-like systems. The configuration scripts it produces are
    67 independent&mdash;running them does not require the <command>autoconf</command> program.</para>
    68 <indexterm zone="ch-system-autoconf autoconf"><primary sortas="b-autoconf">autoconf</primary></indexterm>
    69 </listitem>
    70 </varlistentry>
     76    <variablelist>
     77      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     78      <?dbfo list-presentation="list"?>
     79      <?dbhtml list-presentation="table"?>
    7180
    72 <varlistentry id="autoheader">
    73 <term><command>autoheader</command> </term>
    74 <listitem>
    75 <para>A tool for creating template files of C
    76 <emphasis>#define</emphasis> statements for configure to use</para>
    77 <indexterm zone="ch-system-autoconf autoheader"><primary sortas="b-autoheader">autoheader</primary></indexterm>
    78 </listitem>
    79 </varlistentry>
     81      <varlistentry id="autoconf">
     82        <term><command>autoconf</command></term>
     83        <listitem>
     84          <para>Produces shell scripts that automatically configure software
     85          source code packages to adapt to many kinds of Unix-like systems.
     86          The configuration scripts it produces are independent&mdash;running
     87          them does not require the <command>autoconf</command> program.</para>
     88          <indexterm zone="ch-system-autoconf autoconf">
     89            <primary sortas="b-autoconf">autoconf</primary>
     90          </indexterm>
     91        </listitem>
     92      </varlistentry>
    8093
    81 <varlistentry id="autom4te">
    82 <term><command>autom4te</command></term>
    83 <listitem>
    84 <para>A wrapper for the M4 macro processor</para>
    85 <indexterm zone="ch-system-autoconf autom4te"><primary sortas="b-autom4te">autom4te</primary></indexterm>
    86 </listitem>
    87 </varlistentry>
     94      <varlistentry id="autoheader">
     95        <term><command>autoheader</command> </term>
     96        <listitem>
     97          <para>A tool for creating template files of C
     98          <emphasis>#define</emphasis> statements for configure to use</para>
     99          <indexterm zone="ch-system-autoconf autoheader">
     100            <primary sortas="b-autoheader">autoheader</primary>
     101          </indexterm>
     102        </listitem>
     103      </varlistentry>
    88104
    89 <varlistentry id="autoreconf">
    90 <term><command>autoreconf</command></term>
    91 <listitem>
    92 <para>Automatically runs <command>autoconf</command>,
    93 <command>autoheader</command>, <command>aclocal</command>,
    94 <command>automake</command>, <command>gettextize</command>, and
    95 <command>libtoolize</command> in the correct order to save time
    96 when changes are made to <command>autoconf</command> and
    97 <command>automake</command> template files</para>
    98 <indexterm zone="ch-system-autoconf autoreconf"><primary sortas="b-autoreconf">autoreconf</primary></indexterm>
    99 </listitem>
    100 </varlistentry>
     105      <varlistentry id="autom4te">
     106        <term><command>autom4te</command></term>
     107        <listitem>
     108          <para>A wrapper for the M4 macro processor</para>
     109          <indexterm zone="ch-system-autoconf autom4te">
     110            <primary sortas="b-autom4te">autom4te</primary>
     111          </indexterm>
     112        </listitem>
     113      </varlistentry>
    101114
    102 <varlistentry id="autoscan">
    103 <term><command>autoscan</command> </term>
    104 <listitem>
    105 <para>Helps to create a <filename>configure.in</filename> file for a
    106 software package; it examines the source files in a directory tree,
    107 searching them for common portability issues, and creates a
    108 <filename>configure.scan</filename> file that serves as as a
    109 preliminary <filename>configure.in</filename> file for the
    110 package</para>
    111 <indexterm zone="ch-system-autoconf autoscan"><primary sortas="b-autoscan">autoscan</primary></indexterm>
    112 </listitem>
    113 </varlistentry>
     115      <varlistentry id="autoreconf">
     116        <term><command>autoreconf</command></term>
     117        <listitem>
     118          <para>Automatically runs <command>autoconf</command>,
     119          <command>autoheader</command>, <command>aclocal</command>,
     120          <command>automake</command>, <command>gettextize</command>, and
     121          <command>libtoolize</command> in the correct order to save time
     122          when changes are made to <command>autoconf</command> and
     123          <command>automake</command> template files</para>
     124          <indexterm zone="ch-system-autoconf autoreconf">
     125            <primary sortas="b-autoreconf">autoreconf</primary>
     126          </indexterm>
     127        </listitem>
     128      </varlistentry>
    114129
    115 <varlistentry id="autoupdate">
    116 <term><command>autoupdate</command></term>
    117 <listitem>
    118 <para>Modifies a <filename>configure.in</filename> file that still
    119 calls <command>autoconf</command> macros by their old names to use the
    120 current macro names</para>
    121 <indexterm zone="ch-system-autoconf autoupdate"><primary sortas="b-autoupdate">autoupdate</primary></indexterm>
    122 </listitem>
    123 </varlistentry>
     130      <varlistentry id="autoscan">
     131        <term><command>autoscan</command> </term>
     132        <listitem>
     133          <para>Helps to create a <filename>configure.in</filename> file for a
     134          software package; it examines the source files in a directory tree,
     135          searching them for common portability issues, and creates a
     136          <filename>configure.scan</filename> file that serves as as a
     137          preliminary <filename>configure.in</filename> file for the
     138          package</para>
     139          <indexterm zone="ch-system-autoconf autoscan">
     140            <primary sortas="b-autoscan">autoscan</primary>
     141          </indexterm>
     142        </listitem>
     143      </varlistentry>
    124144
    125 <varlistentry id="ifnames">
    126 <term><command>ifnames</command> </term>
    127 <listitem>
    128 <para>Helps when writing <filename>configure.in</filename> files
    129 for a software package; it prints the identifiers that the package
    130 uses in C preprocessor conditionals. If a package has already been set
    131 up to have some portability, this program can help determine what
    132 <command>configure</command> needs to check for. It can also fill in
    133 gaps in a <filename>configure.in</filename> file generated by
    134 <command>autoscan</command></para>
    135 <indexterm zone="ch-system-autoconf ifnames"><primary sortas="b-ifnames">ifnames</primary></indexterm>
    136 </listitem>
    137 </varlistentry>
    138 </variablelist>
     145      <varlistentry id="autoupdate">
     146        <term><command>autoupdate</command></term>
     147        <listitem>
     148          <para>Modifies a <filename>configure.in</filename> file that still
     149          calls <command>autoconf</command> macros by their old names to use the
     150          current macro names</para>
     151          <indexterm zone="ch-system-autoconf autoupdate">
     152            <primary sortas="b-autoupdate">autoupdate</primary>
     153          </indexterm>
     154        </listitem>
     155      </varlistentry>
    139156
    140 </sect2>
     157      <varlistentry id="ifnames">
     158        <term><command>ifnames</command> </term>
     159        <listitem>
     160          <para>Helps when writing <filename>configure.in</filename> files
     161          for a software package; it prints the identifiers that the package
     162          uses in C preprocessor conditionals. If a package has already been set
     163          up to have some portability, this program can help determine what
     164          <command>configure</command> needs to check for. It can also fill in
     165          gaps in a <filename>configure.in</filename> file generated by
     166          <command>autoscan</command></para>
     167          <indexterm zone="ch-system-autoconf ifnames">
     168            <primary sortas="b-ifnames">ifnames</primary>
     169          </indexterm>
     170        </listitem>
     171      </varlistentry>
     172
     173    </variablelist>
     174
     175  </sect2>
    141176
    142177</sect1>
    143 

  • chapter06/automake.xml

    rc4dfdaaa r50e693d  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-system-automake" role="wrap">
    7 <title>Automake-&automake-version;</title>
    8 <?dbhtml filename="automake.html"?>
    9 
    10 <indexterm zone="ch-system-automake"><primary sortas="a-Automake">Automake</primary></indexterm>
    11 
    12 <sect2 role="package"><title/>
    13 <para>The Automake package contains programs for generating Makefiles for use
    14 with Autoconf.</para>
    15 
    16 <segmentedlist>
    17 <segtitle>&buildtime;</segtitle>
    18 <segtitle>&diskspace;</segtitle>
    19 <seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem>
    20 </segmentedlist>
    21 
    22 <segmentedlist>
    23 <segtitle>&dependencies;</segtitle>
    24 <seglistitem><seg>Autoconf, Bash, Coreutils,
    25 Diffutils, Grep, M4, Make, Perl, and Sed</seg></seglistitem>
    26 </segmentedlist>
    27 </sect2>
    28 
    29 <sect2 role="installation">
    30 <title>Installation of Automake</title>
    31 
    32 <para>Prepare Automake for compilation:</para>
     9  <?dbhtml filename="automake.html"?>
     10
     11  <title>Automake-&automake-version;</title>
     12
     13  <indexterm zone="ch-system-automake">
     14    <primary sortas="a-Automake">Automake</primary>
     15  </indexterm>
     16
     17  <sect2 role="package">
     18    <title/>
     19
     20    <para>The Automake package contains programs for generating Makefiles for use
     21    with Autoconf.</para>
     22
     23    <segmentedlist>
     24      <segtitle>&buildtime;</segtitle>
     25      <segtitle>&diskspace;</segtitle>
     26
     27      <seglistitem>
     28        <seg>0.2 SBU</seg>
     29        <seg>8.8 MB</seg>
     30      </seglistitem>
     31    </segmentedlist>
     32
     33    <segmentedlist>
     34      <segtitle>&dependencies;</segtitle>
     35
     36      <seglistitem>
     37        <seg>Autoconf, Bash, Coreutils, Diffutils, Grep, M4, Make, Perl,
     38        and Sed</seg>
     39      </seglistitem>
     40    </segmentedlist>
     41
     42  </sect2>
     43
     44  <sect2 role="installation">
     45    <title>Installation of Automake</title>
     46
     47    <para>Prepare Automake for compilation:</para>
    3348
    3449<screen><userinput>./configure --prefix=/usr</userinput></screen>
    3550
    36 <para>Compile the package:</para>
     51    <para>Compile the package:</para>
    3752
    3853<screen><userinput>make</userinput></screen>
    3954
    40 <para>To test the results, issue:
    41 <userinput>make check</userinput>. This takes a long time, about 5 SBUs.</para>
    42 
    43 <para>Install the package:</para>
     55    <para>To test the results, issue:
     56    <userinput>make check</userinput>.
     57    This takes a long time, about 5 SBUs.</para>
     58
     59    <para>Install the package:</para>
    4460
    4561<screen><userinput>make install</userinput></screen>
    4662
    47 </sect2>
    48 
    49 
    50 <sect2 id="contents-automake" role="content"><title>Contents of Automake</title>
    51 
    52 <segmentedlist>
    53 <segtitle>Installed programs</segtitle>
    54 <seglistitem><seg>acinstall, aclocal, aclocal-&automake-version;,
    55 automake, automake-&automake-version;,
    56 compile, config.guess, config.sub, depcomp, elisp-comp, install-sh, mdate-sh,
    57 missing, mkinstalldirs, py-compile, symlink-tree, and ylwrap</seg></seglistitem>
    58 </segmentedlist>
    59 
    60 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    61 <?dbfo list-presentation="list"?>
    62 <?dbhtml list-presentation="table"?>
    63 
    64 <varlistentry id="acinstall">
    65 <term><command>acinstall</command></term>
    66 <listitem>
    67 <para>A script that installs aclocal-style M4 files</para>
    68 <indexterm zone="ch-system-automake acinstall"><primary sortas="b-acinstall">acinstall</primary></indexterm>
    69 </listitem>
    70 </varlistentry>
    71 
    72 <varlistentry id="aclocal">
    73 <term><command>aclocal</command></term>
    74 <listitem>
    75 <para>Generates <filename>aclocal.m4</filename>
    76 files based on the contents of <filename>configure.in</filename> files</para>
    77 <indexterm zone="ch-system-automake aclocal"><primary sortas="b-aclocal">aclocal</primary></indexterm>
    78 </listitem>
    79 </varlistentry>
    80 
    81 <varlistentry id="aclocal-version">
    82 <term><command>aclocal-&automake-version;</command></term>
    83 <listitem>
    84 <para>A hard link to <command>aclocal</command></para>
    85 <indexterm zone="ch-system-automake aclocal-version"><primary
    86 sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary></indexterm>
    87 </listitem>
    88 </varlistentry>
    89 
    90 <varlistentry id="automake">
    91 <term><command>automake</command></term>
    92 <listitem>
    93 <para>A tool for automatically generating
    94 <filename>Makefile.in</filename> files from
    95 <filename>Makefile.am</filename> files. To create all the
    96 <filename>Makefile.in</filename> files for a package, run this program
    97 in the top-level directory. By scanning the
    98 <filename>configure.in</filename> file, it automatically finds each
    99 appropriate <filename>Makefile.am</filename> file and generates the
    100 corresponding <filename>Makefile.in</filename> file</para>
    101 <indexterm zone="ch-system-automake automake"><primary sortas="b-automake">automake</primary></indexterm>
    102 </listitem>
    103 </varlistentry>
    104 
    105 <varlistentry id="automake-version">
    106 <term><command>automake-&automake-version;</command></term>
    107 <listitem>
    108 <para>A hard link to <command>automake</command></para>
    109 <indexterm zone="ch-system-automake automake-version"><primary
    110 sortas="b-automake-&automake-version;">automake-&automake-version;</primary></indexterm>
    111 </listitem>
    112 </varlistentry>
    113 
    114 <varlistentry id="compile">
    115 <term><command>compile</command></term>
    116 <listitem>
    117 <para>A wrapper for compilers</para>
    118 <indexterm zone="ch-system-automake compile"><primary sortas="b-compile">compile</primary></indexterm>
    119 </listitem>
    120 </varlistentry>
    121 
    122 <varlistentry id="config.guess">
    123 <term><command>config.guess</command></term>
    124 <listitem>
    125 <para>A script that attempts to guess
    126 the canonical triplet for the given build, host, or target architecture</para>
    127 <indexterm zone="ch-system-automake config.guess"><primary sortas="b-config.guess">config.guess</primary></indexterm>
    128 </listitem>
    129 </varlistentry>
    130 
    131 <varlistentry id="config.sub">
    132 <term><command>config.sub</command></term>
    133 <listitem>
    134 <para>A configuration validation subroutine script</para>
    135 <indexterm zone="ch-system-automake config.sub"><primary sortas="b-config.sub">config.sub</primary></indexterm>
    136 </listitem>
    137 </varlistentry>
    138 
    139 <varlistentry id="depcomp">
    140 <term><command>depcomp</command></term>
    141 <listitem>
    142 <para>A script for compiling a program so that dependency information
    143 is generated in addition to the desired output</para>
    144 <indexterm zone="ch-system-automake depcomp"><primary sortas="b-depcomp">depcomp</primary></indexterm>
    145 </listitem>
    146 </varlistentry>
    147 
    148 <varlistentry id="elisp-comp">
    149 <term><command>elisp-comp</command></term>
    150 <listitem>
    151 <para>Byte-compiles Emacs Lisp code</para>
    152 <indexterm zone="ch-system-automake elisp-comp"><primary sortas="b-elisp-comp">elisp-comp</primary></indexterm>
    153 </listitem>
    154 </varlistentry>
    155 
    156 <varlistentry id="install-sh">
    157 <term><command>install-sh</command></term>
    158 <listitem>
    159 <para>A script that installs a program, script, or data file</para>
    160 <indexterm zone="ch-system-automake install-sh"><primary sortas="b-install-sh">install-sh</primary></indexterm>
    161 </listitem>
    162 </varlistentry>
    163 
    164 <varlistentry id="mdate-sh">
    165 <term><command>mdate-sh</command></term>
    166 <listitem>
    167 <para>A script that prints the modification time of a file or directory</para>
    168 <indexterm zone="ch-system-automake mdate-sh"><primary sortas="b-mdate-sh">mdate-sh</primary></indexterm>
    169 </listitem>
    170 </varlistentry>
    171 
    172 <varlistentry id="missing">
    173 <term><command>missing</command></term>
    174 <listitem>
    175 <para>A script acting as a common stub for missing GNU programs during
    176 an installation</para>
    177 <indexterm zone="ch-system-automake missing"><primary sortas="b-missing">missing</primary></indexterm>
    178 </listitem>
    179 </varlistentry>
    180 
    181 <varlistentry id="mkinstalldirs">
    182 <term><command>mkinstalldirs</command></term>
    183 <listitem>
    184 <para>A script that creates a directory tree</para>
    185 <indexterm zone="ch-system-automake mkinstalldirs"><primary sortas="b-mkinstalldirs">mkinstalldirs</primary></indexterm>
    186 </listitem>
    187 </varlistentry>
    188 
    189 <varlistentry id="py-compile">
    190 <term><command>py-compile</command></term>
    191 <listitem>
    192 <para>Compiles a Python program</para>
    193 <indexterm zone="ch-system-automake py-compile"><primary sortas="b-py-compile">py-compile</primary></indexterm>
    194 </listitem>
    195 </varlistentry>
    196 
    197 <varlistentry id="symlink-tree">
    198 <term><command>symlink-tree</command></term>
    199 <listitem>
    200 <para>A script to create a symlink tree of a directory tree</para>
    201 <indexterm zone="ch-system-automake symlink-tree"><primary sortas="b-symlink-tree">symlink-tree</primary></indexterm>
    202 </listitem>
    203 </varlistentry>
    204 
    205 <varlistentry id="ylwrap">
    206 <term><command>ylwrap</command></term>
    207 <listitem>
    208 <para>A wrapper for <command>lex</command> and <command>yacc</command></para>
    209 <indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm>
    210 </listitem>
    211 </varlistentry>
    212 </variablelist>
    213 
    214 </sect2>
     63  </sect2>
     64
     65
     66  <sect2 id="contents-automake" role="content">
     67    <title>Contents of Automake</title>
     68
     69    <segmentedlist>
     70      <segtitle>Installed programs</segtitle>
     71
     72      <seglistitem>
     73        <seg>acinstall, aclocal, aclocal-&automake-version;, automake,
     74        automake-&automake-version;, compile, config.guess, config.sub,
     75        depcomp, elisp-comp, install-sh, mdate-sh, missing, mkinstalldirs,
     76        py-compile, symlink-tree, and ylwrap</seg>
     77      </seglistitem>
     78    </segmentedlist>
     79
     80    <variablelist>
     81      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     82      <?dbfo list-presentation="list"?>
     83      <?dbhtml list-presentation="table"?>
     84
     85      <varlistentry id="acinstall">
     86        <term><command>acinstall</command></term>
     87        <listitem>
     88          <para>A script that installs aclocal-style M4 files</para>
     89          <indexterm zone="ch-system-automake acinstall">
     90            <primary sortas="b-acinstall">acinstall</primary>
     91          </indexterm>
     92        </listitem>
     93      </varlistentry>
     94
     95      <varlistentry id="aclocal">
     96        <term><command>aclocal</command></term>
     97        <listitem>
     98          <para>Generates <filename>aclocal.m4</filename> files based on the
     99          contents of <filename>configure.in</filename> files</para>
     100          <indexterm zone="ch-system-automake aclocal">
     101            <primary sortas="b-aclocal">aclocal</primary>
     102          </indexterm>
     103        </listitem>
     104      </varlistentry>
     105
     106      <varlistentry id="aclocal-version">
     107        <term><command>aclocal-&automake-version;</command></term>
     108        <listitem>
     109          <para>A hard link to <command>aclocal</command></para>
     110          <indexterm zone="ch-system-automake aclocal-version">
     111            <primary sortas="b-aclocal-&automake-version;">aclocal-&automake-version;</primary>
     112          </indexterm>
     113        </listitem>
     114      </varlistentry>
     115
     116      <varlistentry id="automake">
     117        <term><command>automake</command></term>
     118        <listitem>
     119          <para>A tool for automatically generating
     120          <filename>Makefile.in</filename> files from
     121          <filename>Makefile.am</filename> files. To create all the
     122          <filename>Makefile.in</filename> files for a package, run this program
     123          in the top-level directory. By scanning the
     124          <filename>configure.in</filename> file, it automatically finds each
     125          appropriate <filename>Makefile.am</filename> file and generates the
     126          corresponding <filename>Makefile.in</filename> file</para>
     127          <indexterm zone="ch-system-automake automake">
     128            <primary sortas="b-automake">automake</primary>
     129          </indexterm>
     130        </listitem>
     131      </varlistentry>
     132
     133      <varlistentry id="automake-version">
     134        <term><command>automake-&automake-version;</command></term>
     135        <listitem>
     136          <para>A hard link to <command>automake</command></para>
     137          <indexterm zone="ch-system-automake automake-version">
     138            <primary sortas="b-automake-&automake-version;">automake-&automake-version;</primary>
     139          </indexterm>
     140        </listitem>
     141      </varlistentry>
     142
     143      <varlistentry id="compile">
     144        <term><command>compile</command></term>
     145        <listitem>
     146          <para>A wrapper for compilers</para>
     147          <indexterm zone="ch-system-automake compile">
     148            <primary sortas="b-compile">compile</primary>
     149          </indexterm>
     150        </listitem>
     151      </varlistentry>
     152
     153      <varlistentry id="config.guess">
     154        <term><command>config.guess</command></term>
     155        <listitem>
     156          <para>A script that attempts to guess the canonical triplet for
     157          the given build, host, or target architecture</para>
     158          <indexterm zone="ch-system-automake config.guess">
     159            <primary sortas="b-config.guess">config.guess</primary>
     160          </indexterm>
     161        </listitem>
     162      </varlistentry>
     163
     164      <varlistentry id="config.sub">
     165        <term><command>config.sub</command></term>
     166        <listitem>
     167          <para>A configuration validation subroutine script</para>
     168          <indexterm zone="ch-system-automake config.sub">
     169            <primary sortas="b-config.sub">config.sub</primary>
     170          </indexterm>
     171        </listitem>
     172      </varlistentry>
     173
     174      <varlistentry id="depcomp">
     175        <term><command>depcomp</command></term>
     176        <listitem>
     177          <para>A script for compiling a program so that dependency information
     178          is generated in addition to the desired output</para>
     179          <indexterm zone="ch-system-automake depcomp">
     180            <primary sortas="b-depcomp">depcomp</primary>
     181          </indexterm>
     182        </listitem>
     183      </varlistentry>
     184
     185      <varlistentry id="elisp-comp">
     186        <term><command>elisp-comp</command></term>
     187        <listitem>
     188          <para>Byte-compiles Emacs Lisp code</para>
     189          <indexterm zone="ch-system-automake elisp-comp">
     190            <primary sortas="b-elisp-comp">elisp-comp</primary>
     191          </indexterm>
     192        </listitem>
     193      </varlistentry>
     194
     195      <varlistentry id="install-sh">
     196        <term><command>install-sh</command></term>
     197        <listitem>
     198          <para>A script that installs a program, script, or data file</para>
     199          <indexterm zone="ch-system-automake install-sh">
     200            <primary sortas="b-install-sh">install-sh</primary>
     201          </indexterm>
     202        </listitem>
     203      </varlistentry>
     204
     205      <varlistentry id="mdate-sh">
     206        <term><command>mdate-sh</command></term>
     207        <listitem>
     208          <para>A script that prints the modification time of a file or
     209          directory</para>
     210          <indexterm zone="ch-system-automake mdate-sh">
     211            <primary sortas="b-mdate-sh">mdate-sh</primary>
     212          </indexterm>
     213        </listitem>
     214      </varlistentry>
     215
     216      <varlistentry id="missing">
     217        <term><command>missing</command></term>
     218        <listitem>
     219          <para>A script acting as a common stub for missing GNU programs during
     220          an installation</para>
     221          <indexterm zone="ch-system-automake missing">
     222            <primary sortas="b-missing">missing</primary>
     223          </indexterm>
     224        </listitem>
     225      </varlistentry>
     226
     227      <varlistentry id="mkinstalldirs">
     228        <term><command>mkinstalldirs</command></term>
     229        <listitem>
     230          <para>A script that creates a directory tree</para>
     231          <indexterm zone="ch-system-automake mkinstalldirs">
     232            <primary sortas="b-mkinstalldirs">mkinstalldirs</primary>
     233          </indexterm>
     234        </listitem>
     235      </varlistentry>
     236
     237      <varlistentry id="py-compile">
     238        <term><command>py-compile</command></term>
     239        <listitem>
     240          <para>Compiles a Python program</para>
     241          <indexterm zone="ch-system-automake py-compile">
     242            <primary sortas="b-py-compile">py-compile</primary>
     243          </indexterm>
     244        </listitem>
     245      </varlistentry>
     246
     247      <varlistentry id="symlink-tree">
     248        <term><command>symlink-tree</command></term>
     249        <listitem>
     250          <para>A script to create a symlink tree of a directory tree</para>
     251          <indexterm zone="ch-system-automake symlink-tree">
     252            <primary sortas="b-symlink-tree">symlink-tree</primary>
     253          </indexterm>
     254        </listitem>
     255      </varlistentry>
     256
     257      <varlistentry id="ylwrap">
     258        <term><command>ylwrap</command></term>
     259        <listitem>
     260          <para>A wrapper for <command>lex</command> and
     261          <command>yacc</command></para>
     262          <indexterm zone="ch-system-automake ylwrap">
     263            <primary sortas="b-ylwrap">ylwrap</primary>
     264          </indexterm>
     265        </listitem>
     266      </varlistentry>
     267
     268    </variablelist>
     269
     270  </sect2>
    215271
    216272</sect1>
    217 
Note: See TracChangeset for help on using the changeset viewer.