README

   1 Autoconf
   2
   3 Autoconf is an extensible package of m4 macros that produce shell
   4 scripts to automatically configure software source code packages.
   5 These scripts can adapt the packages to many kinds of UNIX-like
   6 systems without manual user intervention.  Autoconf creates a
   7 configuration script for a package from a template file that lists the
   8 operating system features that the package can use, in the form of m4
   9 macro calls.
  10
  11 Producing configuration scripts using Autoconf requires GNU m4.  You
  12 must install GNU m4 (version 1.1 or later, preferably 1.3 or later
  13 for better performance) before configuring Autoconf, so that
  14 Autoconf's configure script can find it.  The configuration scripts
  15 produced by Autoconf are self-contained, so their users do not need to
  16 have Autoconf (or GNU m4).
  17
  18 Also, some optional utilities that come with Autoconf use Perl, TCL,
  19 and the TCL packages Expect and DejaGNU.  However, none of those
  20 are required in order to use the main Autoconf program.  If they are
  21 not present, the affected Autoconf utilities will not be installed.
  22
  23 The file INSTALL can be distributed with packages that use
  24 Autoconf-generated configure scripts and Makefiles that conform to the
  25 GNU coding standards.  The package's README can just give an overview
  26 of the package, where to report bugs, and a pointer to INSTALL for
  27 instructions on compilation and installation.  This removes the need
  28 to maintain many similar sets of installation instructions.
  29
  30 The file `acconfig.h' contains short descriptions of the C preprocessor
  31 variables that Autoconf can define, suitable for copying into other
  32 packages' configuration headers or Makefile.in files.  You can use the
  33 program `autoheader' to automatically create a configuration header
  34 from a `configure.in', based on the information in `acconfig.h'.
  35
  36 Mail suggestions and bug reports for Autoconf to autoconf@gnu.org.
  37 Please include the Autoconf version number, which you can get by running
  38 "autoconf --version".  The current autoconf maintainer is Ben Elliston
  39 <bje@cygnus.com>.