---

5.4 Autoconf macros supplied with Automake

AM_CONFIG_HEADER

Automake will generate rules to automatically regenerate the config header. If you do use this macro, you must create the file stamp-h.in in your source directory. It can be empty.

AM_CYGWIN32

Check to see if this configure is being run in the ‘Cygwin32’ environment. (FIXME xref). If so, define output variable EXEEXT to ‘.exe’; otherwise define it to the empty string. Automake recognizes this macro and uses it to generate Makefile.ins which will automatically work under ‘Cygwin32’. In the ‘Cygwin32’ environment, gcc generates executables whose names end in ‘.exe’, even if this was not specified on the command line. Automake adds special code to Makefile.in to gracefully deal with this.

AM_FUNC_STRTOD

If the strtod function is not available, or does not work correctly (like the one on SunOS 5.4), add strtod.o to output variable LIBOBJS.

AM_FUNC_ERROR_AT_LINE

If the function error_at_line is not found, then add error.o to LIBOBJS.

AM_FUNC_MKTIME

Check for a working mktime function. If not found, add mktime.o to ‘LIBOBJS’.

AM_FUNC_OBSTACK

Check for the GNU obstacks code; if not found, add obstack.o to ‘LIBOBJS’.

AM_C_PROTOTYPES

Check to see if function prototypes are understood by the compiler. If so, define ‘PROTOTYPES’ and set the output variables ‘U’ and ‘ANSI2KNR’ to the empty string. Otherwise, set ‘U’ to ‘_’ and ‘ANSI2KNR’ to ‘./ansi2knr’. Automake uses these values to implement automatic de-ANSI-fication.

AM_HEADER_TIOCGWINSZ_NEEDS_SYS_IOCTL

If the use of TIOCGWINSZ requires <sys/ioctl.h>, then define GWINSZ_IN_SYS_IOCTL. Otherwise TIOCGWINSZ can be found in <termios.h>.

AM_INIT_AUTOMAKE

Runs many macros that most configure.in’s need. This macro has two required arguments, the package and the version number. By default this macro AC_DEFINE’s ‘PACKAGE’ and ‘VERSION’. This can be avoided by passing in a non-empty third argument.

AM_PATH_LISPDIR

Searches for the program emacs, and, if found, sets the output variable lispdir to the full path to Emacs’ site-lisp directory.

AM_PROG_CC_STDC

If the C compiler in not in ANSI C mode by default, try to add an option to output variable CC to make it so. This macro tries various options that select ANSI C on some system or another. It considers the compiler to be in ANSI C mode if it defines __STDC__ to 1 and handles function prototypes correctly.

If you use this macro, you should check after calling it whether the C compiler has been set to accept ANSI C; if not, the shell variable am_cv_prog_cc_stdc is set to ‘no’. If you wrote your source code in ANSI C, you can make an un-ANSIfied copy of it by using the ansi2knr option.

AM_PROG_INSTALL

Like AC_PROG_INSTALL, but also defines INSTALL_SCRIPT.

AM_SANITY_CHECK

This checks to make sure that a file created in the build directory is newer than a file in the source directory. This can fail on systems where the clock is set incorrectly. This macro is automatically run from AM_INIT_AUTOMAKE.

AM_SYS_POSIX_TERMIOS

Check to see if POSIX termios headers and functions are available on the system. If so, set the shell variable am_cv_sys_posix_termios to ‘yes’. If not, set the variable to ‘no’.

AM_TYPE_PTRDIFF_T

Define ‘HAVE_PTRDIFF_T’ if the type ‘ptrdiff_t’ is defined in <stddef.h>.

AM_WITH_DMALLOC

Add support for the dmalloc package. If the user configures with ‘--with-dmalloc’, then define WITH_DMALLOC and add ‘-ldmalloc’ to LIBS. The dmalloc package can be found at ftp://ftp.letters.com/src/dmalloc/dmalloc.tar.gz

AM_WITH_REGEX

Adds ‘--with-regex’ to the configure command line. If specified (the default), then the ‘regex’ regular expression library is used, regex.o is put into ‘LIBOBJS’, and ‘WITH_REGEX’ is defined.. If ‘--without-regex’ is given, then the ‘rx’ regular expression library is used, and rx.o is put into ‘LIBOBJS’.