---

5.2 Other things Automake recognizes

Automake will also recognize the use of certain macros and tailor the generated Makefile.in appropriately. Currently recognized macros and their effects are:

AC_CONFIG_HEADER

Automake requires the use of AM_CONFIG_HEADER (see Autoconf macros supplied with Automake), which is similar to AC_CONFIG_HEADER (see Configuration Header Files in The Autoconf Manual), but does some useful Automake-specific work.

AC_CONFIG_AUX_DIR

Automake will look for various helper scripts, such as mkinstalldirs, in the directory named in this macro invocation. If not seen, the scripts are looked for in their ‘standard’ locations (either the top source directory, or in the source directory corresponding to the current Makefile.am, whichever is appropriate). See Finding ‘configure’ Input in The Autoconf Manual. FIXME: give complete list of things looked for in this directory

AC_PATH_XTRA

Automake will insert definitions for the variables defined by AC_PATH_XTRA into each Makefile.in that builds a C program or library. See System Services in The Autoconf Manual.

AC_CANONICAL_HOST

Automake will ensure that config.guess and config.sub exist. Also, the Makefile variables ‘host_alias’ and ‘host_triplet’ are introduced. See Getting the Canonical System Type in The Autoconf Manual.

AC_CANONICAL_SYSTEM

This is similar to AC_CANONICAL_HOST, but also defines the Makefile variables ‘build_alias’ and ‘target_alias’. See Getting the Canonical System Type in The Autoconf Manual.

AC_FUNC_ALLOCA

AC_FUNC_ERROR_AT_LINE

AC_FUNC_FNMATCH

AC_FUNC_GETLOADAVG

AC_FUNC_MEMCMP

AC_FUNC_MKTIME

AC_FUNC_OBSTACK

AC_FUNC_STRTOD

AC_REPLACE_FUNCS

AC_REPLACE_GNU_GETOPT

AC_STRUCT_ST_BLOCKS

AM_WITH_REGEX

Automake will ensure that the appropriate dependencies are generated for the objects corresponding to these macros. Also, Automake will verify that the appropriate source files are part of the distribution. Note that Automake does not come with any of the C sources required to use these macros, so automake -a will not install the sources. See Building a library, for more information. Also, see Particular Function Checks in The Autoconf Manual.

AC_LIBOBJ

LIBOBJS

AC_LIBSOURCE

AC_LIBSOURCES

Automake will detect statements which put .o files into LIBOBJS, or pass .o files to AC_LIBOBJ, and will treat these additional files as if they were discovered via AC_REPLACE_FUNCS. Similarly, Automake will also distribute file listed in AC_LIBSOURCE and AC_LIBSOURCES.

Note that assignments to LIBOBJS is a construct which is being phased out; they will be ignored in a future release of Automake. You should call the AC_LIBOBJ macro instead. See Generic Function Checks in The Autoconf Manual.

AC_PROG_RANLIB

This is required if any libraries are built in the package. See Particular Program Checks in The Autoconf Manual.

AC_PROG_CXX

This is required if any C++ source is included. See Particular Program Checks in The Autoconf Manual.

AC_PROG_F77

This is required if any Fortran 77 source is included. This macro is distributed with Autoconf version 2.13 and later. See Particular Program Checks in The Autoconf Manual.

AC_F77_LIBRARY_LDFLAGS

This is required for programs and shared libraries that are a mixture of languages that include Fortran 77 (see Mixing Fortran 77 With C and C++). See Autoconf macros supplied with Automake.

AC_PROG_LIBTOOL

Automake will turn on processing for libtool (see Introduction in The Libtool Manual).

AC_PROG_YACC

If a Yacc source file is seen, then you must either use this macro or define the variable ‘YACC’ in configure.in. The former is preferred (see Particular Program Checks in The Autoconf Manual).

AC_PROG_LEX

If a Lex source file is seen, then this macro must be used. See Particular Program Checks in The Autoconf Manual.

AM_C_PROTOTYPES

This is required when using automatic de-ANSI-fication; see Automatic de-ANSI-fication.

AM_GNU_GETTEXT

This macro is required for packages which use GNU gettext (see Gettext). It is distributed with gettext. If Automake sees this macro it ensures that the package meets some of gettext’s requirements.

AM_MAINTAINER_MODE ¶

This macro adds a ‘--enable-maintainer-mode’ option to configure. If this is used, automake will cause ‘maintainer-only’ rules to be turned off by default in the generated Makefile.ins. This macro is disallowed in ‘Gnits’ mode (see The effect of --gnu and --gnits). This macro defines the ‘MAINTAINER_MODE’ conditional, which you can use in your own Makefile.am.

AC_SUBST

AC_CHECK_TOOL

AC_CHECK_PROG

AC_CHECK_PROGS

AC_PATH_PROG

AC_PATH_PROGS

For each of these macros, the first argument is automatically defined as a variable in each generated Makefile.in. See Setting Output Variables in The Autoconf Manual, and Generic Program Checks in The Autoconf Manual.