aboutsummaryrefslogtreecommitdiffstats
path: root/chapter08/automake.xml
diff options
context:
space:
mode:
Diffstat (limited to 'chapter08/automake.xml')
-rw-r--r--chapter08/automake.xml141
1 files changed, 141 insertions, 0 deletions
diff --git a/chapter08/automake.xml b/chapter08/automake.xml
new file mode 100644
index 000000000..f89f71ced
--- /dev/null
+++ b/chapter08/automake.xml
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../general.ent">
+ %general-entities;
+]>
+
+<sect1 id="ch-system-automake" role="wrap">
+ <?dbhtml filename="automake.html"?>
+
+ <sect1info condition="script">
+ <productname>automake</productname>
+ <productnumber>&automake-version;</productnumber>
+ <address>&automake-url;</address>
+ </sect1info>
+
+ <title>Automake-&automake-version;</title>
+
+ <indexterm zone="ch-system-automake">
+ <primary sortas="a-Automake">Automake</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title/>
+
+ <para>The Automake package contains programs for generating Makefiles for use
+ with Autoconf.</para>
+
+ <segmentedlist>
+ <segtitle>&buildtime;</segtitle>
+ <segtitle>&diskspace;</segtitle>
+
+ <seglistitem>
+ <seg>&automake-fin-sbu;</seg>
+ <seg>&automake-fin-du;</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of Automake</title>
+
+ <para>Fix a failing test:</para>
+
+<screen><userinput remap="pre">sed -i "s/''/etags/" t/tags-lisp-space.sh</userinput></screen>
+
+ <para>Prepare Automake for compilation:</para>
+
+<screen><userinput remap="configure">./configure --prefix=/usr --docdir=/usr/share/doc/automake-&automake-version;</userinput></screen>
+
+ <para>Compile the package:</para>
+
+<screen><userinput remap="make">make</userinput></screen>
+
+ <para> Using the -j4 make option speeds up the tests, even on systems with
+ only one processor, due to internal delays in individual tests. To test
+ the results, issue:</para>
+
+<screen><userinput remap="test">make -j4 check</userinput></screen>
+
+ <para>Install the package:</para>
+
+<screen><userinput remap="install">make install</userinput></screen>
+
+ </sect2>
+
+
+ <sect2 id="contents-automake" role="content">
+ <title>Contents of Automake</title>
+
+ <segmentedlist>
+ <segtitle>Installed programs</segtitle>
+ <segtitle>Installed directories</segtitle>
+
+ <seglistitem>
+ <seg>aclocal, aclocal-&am-minor-version; (hard linked with aclocal), automake, and
+ automake-&am-minor-version; (hard linked with automake) </seg>
+ <seg>/usr/share/aclocal-&am-minor-version;, /usr/share/automake-&am-minor-version;, and
+ /usr/share/doc/automake-&automake-version;</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="aclocal">
+ <term><command>aclocal</command></term>
+ <listitem>
+ <para>Generates <filename>aclocal.m4</filename> files based on the
+ contents of <filename>configure.in</filename> files</para>
+ <indexterm zone="ch-system-automake aclocal">
+ <primary sortas="b-aclocal">aclocal</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="aclocalversion">
+ <term><command>aclocal-&am-minor-version;</command></term>
+ <listitem>
+ <para>A hard link to <command>aclocal</command></para>
+ <indexterm zone="ch-system-automake aclocalversion">
+ <primary sortas="b-aclocal-&am-minor-version;">aclocal-&am-minor-version;</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="automake">
+ <term><command>automake</command></term>
+ <listitem>
+ <para>A tool for automatically generating
+ <filename>Makefile.in</filename> files from
+ <filename>Makefile.am</filename> files [To create all the
+ <filename>Makefile.in</filename> files for a package, run this program
+ 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="automake-version">
+ <term><command>automake-&am-minor-version;</command></term>
+ <listitem>
+ <para>A hard link to <command>automake</command></para>
+ <indexterm zone="ch-system-automake automake-version">
+ <primary sortas="b-automake-&am-minor-version;">automake-&am-minor-version;</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+</sect1>