| 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>. |
|---|
