chapter06/autoconf.xml

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