gnu/dist/autoconf/README

   1 -*- text -*-
   2
   3 Autoconf
   4
   5 Autoconf is an extensible package of M4 macros that produce shell
   6 scripts to automatically configure software source code packages.
   7 These scripts can adapt the packages to many kinds of UNIX-like
   8 systems without manual user intervention.  Autoconf creates a
   9 configuration script for a package from a template file that lists the
  10 operating system features that the package can use, in the form of M4
  11 macro calls.
  12
  13 Producing configuration scripts using Autoconf requires GNU M4.  You
  14 must install GNU M4 (version 1.4 or later) before configuring
  15 Autoconf, so that Autoconf's configure script can find it.  The
  16 configuration scripts produced by Autoconf are self-contained, so
  17 their users do not need to have Autoconf (or GNU M4).
  18
  19 Some optional utilities that come with Autoconf, autoscan and
  20 autoupdate, use Perl 5.5.  However, it is not required in order to use
  21 the main Autoconf programs.  If it is not present, the affected
  22 Autoconf utilities will not be installed.
  23
  24 The file INSTALL should be distributed with packages that use
  25 Autoconf-generated configure scripts and Makefiles that conform to the
  26 GNU coding standards.  The package's README can just give an overview
  27 of the package, where to report bugs, and a pointer to INSTALL for
  28 instructions on compilation and installation.  This removes the need
  29 to maintain many similar sets of installation instructions.
  30
  31 Be sure to read BUGS (especially if this Autoconf is not an official
  32 release) and INSTALL.
  33
  34 This version of the package Autoconf uses a fixed version of Automake
  35 1.4.  If ever you alter some Makefile.am (i.e., if you hack Autoconf
  36 itself), you'll have to use either a more recent release of Automake,
  37 or download the patch from
  38
  39    http://packages.debian.org/stable/devel/automake.html
  40
  41 Mail suggestions to autoconf@gnu.org, bug reports to
  42 autoconf-bugs@gnu.org, and patches to autoconf-patches@gnu.org.
  43 Please include the Autoconf version number, which you can get by
  44 running `autoconf --version'.