.
[autoconf.git] / README
blob2b903b4b92783a76fcff405d4c5393786fc51934
1 Autoconf
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.
11 Producing configuration scripts using Autoconf requires GNU m4.  You
12 must install GNU m4 (version 1.4 or later) before configuring
13 Autoconf, so that Autoconf's configure script can find it.  The
14 configuration scripts produced by Autoconf are self-contained, so
15 their users do not need to have Autoconf (or GNU m4).
17 Also, some optional utilities that come with Autoconf use Perl.
18 However, it is not required in order to use the main Autoconf program.
19 If it is not present, the affected Autoconf utilities will not be
20 installed.
22 You can use the program `autoheader' to automatically create a
23 configuration header from a `configure.in'.
25 The file INSTALL should be distributed with packages that use
26 Autoconf-generated configure scripts and Makefiles that conform to the
27 GNU coding standards.  The package's README can just give an overview
28 of the package, where to report bugs, and a pointer to INSTALL for
29 instructions on compilation and installation.  This removes the need
30 to maintain many similar sets of installation instructions.
32 Mail suggestions and bug reports for Autoconf to autoconf@gnu.org.
33 Please include the Autoconf version number, which you can get by
34 running `autoconf --version'.
36 PS/ Oops, by the way, please read the file `INSTALL' to install
37 Autoconf ;)