[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

4.1 Initializing configure

Every configure script must call AC_INIT before doing anything else. The only other required macro is AC_OUTPUT (see section 4.4 Outputting Files).

Macro: AC_INIT (package, version, [bug-report], [tarname])
Process any command-line arguments and perform various initializations and verifications.

Set the name of the package and its version. These are typically used in `--version' support, including that of configure. The optional argument bug-report should be the email to which users should send bug reports. The package tarname differs from package: the latter designates the full package name (e.g., `GNU Autoconf'), while the former is meant for distribution tar ball names (e.g., `autoconf'). It defaults to package with `GNU ' stripped, lower-cased, and all characters other than alphanumerics and underscores are changed to `-'.

It is preferable that the arguments of AC_INIT be static, i.e., there should not be any shell computation, but they can be computed by M4.

The following M4 macros (e.g., AC_PACKAGE_NAME), output variables (e.g., PACKAGE_NAME), and preprocessor symbols (e.g., PACKAGE_NAME) are defined by AC_INIT:

AC_PACKAGE_NAME, PACKAGE_NAME
Exactly package.

AC_PACKAGE_TARNAME, PACKAGE_TARNAME
Exactly tarname.

AC_PACKAGE_VERSION, PACKAGE_VERSION
Exactly version.

AC_PACKAGE_STRING, PACKAGE_STRING
Exactly `package version'.

AC_PACKAGE_BUGREPORT, PACKAGE_BUGREPORT
Exactly bug-report.



This document was generated by Jeff Bailey on December, 24 2002 using texi2html