diff options
Diffstat (limited to 'chapter06/autoconf.xml')
| -rw-r--r-- | chapter06/autoconf.xml | 101 |
1 files changed, 97 insertions, 4 deletions
diff --git a/chapter06/autoconf.xml b/chapter06/autoconf.xml index ad766f602..790d1408b 100644 --- a/chapter06/autoconf.xml +++ b/chapter06/autoconf.xml @@ -3,13 +3,15 @@ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> -<sect1 id="ch-system-autoconf" xreflabel="Autoconf" role="wrap"> +<sect1 id="ch-system-autoconf" role="wrap"> <title>Autoconf-&autoconf-version;</title> <?dbhtml filename="autoconf.html"?> <indexterm zone="ch-system-autoconf"><primary sortas="a-Autoconf">Autoconf</primary></indexterm> <sect2 role="package"><title/> +<para>The Autoconf package contains programs for producing shell scripts that +can automatically configure source code.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> @@ -17,6 +19,11 @@ <seglistitem><seg>0.5 SBU</seg><seg>7.7 MB</seg></seglistitem> </segmentedlist> +<segmentedlist> +<segtitle>Autoconf installation depends on</segtitle> +<seglistitem><seg>Bash, Coreutils, Diffutils, Grep, +M4, Make, Perl, and Sed</seg></seglistitem> +</segmentedlist> </sect2> <sect2 role="installation"> @@ -31,7 +38,7 @@ <screen><userinput>make</userinput></screen> <para>To test the results, issue: -<userinput>make check</userinput></para> +<userinput>make check</userinput>. This takes a long time, about 2 SBUs.</para> <para>Install the package:</para> @@ -39,11 +46,97 @@ </sect2> - <sect2 id="contents-autoconf" role="content"><title>Contents of Autoconf</title> -<para>See testing</para> +<segmentedlist> +<segtitle>Installed programs</segtitle> +<seglistitem><seg>autoconf, autoheader, autom4te, +autoreconf, autoscan, autoupdate, and ifnames</seg></seglistitem> +</segmentedlist> + +<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> +<?dbfo list-presentation="list"?> + +<varlistentry id="autoconf"> +<term><command>autoconf</command></term> +<listitem> +<para>Produces shell scripts that automatically +configure software source code packages to adapt to many kinds of +Unix-like systems. The configuration scripts it produces are +independent—running them does not require the <command>autoconf</command> program.</para> +<indexterm zone="ch-system-autoconf autoconf"><primary sortas="b-autoconf">autoconf</primary></indexterm> +</listitem> +</varlistentry> + +<varlistentry id="autoheader"> +<term><command>autoheader</command> </term> +<listitem> +<para>A tool for creating template files of C +<emphasis>#define</emphasis> statements for configure to use</para> +<indexterm zone="ch-system-autoconf autoheader"><primary sortas="b-autoheader">autoheader</primary></indexterm> +</listitem> +</varlistentry> + +<varlistentry id="autom4te"> +<term><command>autom4te</command></term> +<listitem> +<para>A wrapper for the M4 macro processor</para> +<indexterm zone="ch-system-autoconf autom4te"><primary sortas="b-autom4te">autom4te</primary></indexterm> +</listitem> +</varlistentry> + +<varlistentry id="autoreconf"> +<term><command>autoreconf</command></term> +<listitem> +<para>Automatically runs <command>autoconf</command>, +<command>autoheader</command>, <command>aclocal</command>, +<command>automake</command>, <command>gettextize</command>, and +<command>libtoolize</command> in the correct order to save time +when changes are made to <command>autoconf</command> and +<command>automake</command> template files</para> +<indexterm zone="ch-system-autoconf autoreconf"><primary sortas="b-autoreconf">autoreconf</primary></indexterm> +</listitem> +</varlistentry> + +<varlistentry id="autoscan"> +<term><command>autoscan</command> </term> +<listitem> +<para>Helps to create a <filename>configure.in</filename> file for a +software package; it examines the source files in a directory tree, +searching them for common portability issues, and creates a +<filename>configure.scan</filename> file that serves as as a +preliminary <filename>configure.in</filename> file for the +package</para> +<indexterm zone="ch-system-autoconf autoscan"><primary sortas="b-autoscan">autoscan</primary></indexterm> +</listitem> +</varlistentry> + +<varlistentry id="autoupdate"> +<term><command>autoupdate</command></term> +<listitem> +<para>Modifies a <filename>configure.in</filename> file that still +calls <command>autoconf</command> macros by their old names to use the +current macro names</para> +<indexterm zone="ch-system-autoconf autoupdate"><primary sortas="b-autoupdate">autoupdate</primary></indexterm> +</listitem> +</varlistentry> + +<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> + |