Ignore:
Timestamp:
02/03/2006 06:23:22 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Children:
fa994c9
Parents:
b4cd3c5
Message:

Ported r7294 to r7325 from trunk to alphabetical branch.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/automake.xml

    rb4cd3c5 re6ab4b5  
    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.