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 use Perl.  However, it
  20 is not required in order to use the main Autoconf programs.  If it is
  21 not present, the affected Autoconf utilities will not be installed.
  22
  23 The file INSTALL should 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 Be sure to read BUGS (especially if this Autoconf is not an official
  31 release) and INSTALL.
  32
  33 Mail suggestions and bug reports for Autoconf to autoconf@gnu.org.
  34 Please include the Autoconf version number, which you can get by
  35 running `autoconf --version'.