* AC_MSG_CHECKING and AC_MSG_RESULT to print test results, on a single line,
whether or not the test succeeds. They obsolete AC_CHECKING and AC_VERBOSE.
* AC_SUBST_FILE, to insert one file into another.
+* AC_PROG_CC_ANSI to try to put the C compiler into ANSI C mode.
+* AC_FUNC_STRFTIME, to find strftime even if it's in -lintl.
+* AC_FUNC_GETMNTENT, to find getmntent even if it's in -lsun or -lseq.
** Changed macros:
* Many macros renamed systematically, but old names are accepted for
------------------------------------------------------------------------------
-* Replace the current ad-hoc macros for Dynix, SCO, ISC, etc.
-Perhaps there should be macros for certain functions (statfs, wait) or
-classes of functions (POSIX, NIS) that do everything necessary, instead.
-Select the right C compiler and POSIX/ANSI C options automatically.
+* Add AC_PROG_CC_POSIX to replace the current ad-hoc macros for AIX,
+Minix, ISC, etc.
------------------------------------------------------------------------------
------------------------------------------------------------------------------
-* Look at Jim Avera's code to allow [ and ] in egrep patterns and
-AC_DEFINE args.
+* Allow [ and ] in egrep patterns and AC_DEFINE args.
------------------------------------------------------------------------------
if test -n "${program_transform_name}"; then
# Double any \ or $.
echo 's,\\,\\\\,g; s,\$,$$,g' > conftestsed
- program_transform_name="-e `echo ${program_transform_name} | sed -f conftestsed`"
+ program_transform_name="`echo ${program_transform_name}|sed -f conftestsed`"
rm -f conftestsed
fi
test "${program_prefix}" != NONE &&
- program_transform_name="-e s,^,${program_prefix}, ${program_transform_name}"
+ program_transform_name="s,^,${program_prefix},; ${program_transform_name}"
# Use a double $ so make ignores it.
test "${program_suffix}" != NONE &&
- program_transform_name="-e s,\$\$,${program_suffix}, ${program_transform_name}"
+ program_transform_name="s,\$\$,${program_suffix},; ${program_transform_name}"
# sed with no file args requires a program.
-test "${program_transform_name}" = "" && program_transform_name="-e s,x,x,"
+test "${program_transform_name}" = "" && program_transform_name="s,x,x,"
AC_SUBST(program_transform_name)dnl
])
*) AC_MSG_ERROR(can only configure for one host and one target at a time) ;;
esac
-# Make sure we can run config.sub.
-if ${ac_config_sub} sun4 >/dev/null 2>&1; then :
-else AC_MSG_ERROR(can not run ${ac_config_sub})
-fi
-
AC_CANONICAL_HOST
AC_CANONICAL_TARGET
AC_CANONICAL_BUILD
AC_DEFUN(AC_CANONICAL_HOST,
[AC_REQUIRE([AC_CONFIG_AUX_DIR_DEFAULT])dnl
+
+# Make sure we can run config.sub.
+if ${ac_config_sub} sun4 >/dev/null 2>&1; then :
+else AC_MSG_ERROR(can not run ${ac_config_sub})
+fi
+
AC_MSG_CHECKING(host system type)
host_alias=$host
AC_DEFUN(AC_LONG_FILE_NAMES, [indir([AC_SYS_LONG_FILE_NAMES])])dnl
AC_DEFUN(AC_RESTARTABLE_SYSCALLS, [indir([AC_SYS_RESTARTABLE_SYSCALLS])])dnl
AC_DEFUN(AC_FIND_X, [indir([AC_PATH_X])])dnl
-AC_DEFUN(AC_FIND_X_XMKMF, [indir([AC_PATH_X_XMKMF])])dnl
-AC_DEFUN(AC_FIND_X_DIRECT, [indir([AC_PATH_X_DIRECT])])dnl
AC_DEFUN(AC_FIND_XTRA, [indir([AC_PATH_XTRA])])dnl
AC_DEFUN(AC_AIX, [indir([AC_OS_AIX])])dnl
AC_DEFUN(AC_MINIX, [indir([AC_OS_MINIX])])dnl
AC_DEFUN(AC_ISC_POSIX, [indir([AC_OS_ISC])])dnl
-AC_DEFUN(AC_XENIX_DIR, [indir([AC_OS_XENIX])])dnl
-AC_DEFUN(AC_SCO_INTL, [indir([AC_OS_SCO])])dnl
-AC_DEFUN(AC_IRIX_SUN, [indir([AC_OS_IRIX])])dnl
-AC_DEFUN(AC_DYNIX_SEQ, [indir([AC_OS_DYNIX])])dnl
fi
])
+define(AC_PROG_CC_ANSI,
+[AC_MSG_CHECKING(for ${CC-cc} option to accept ANSI C)
+AC_CACHE_VAL(ac_cv_prog_cc_ansi,
+[ac_cv_prog_cc_ansi=no
+ac_save_CFLAGS="$CFLAGS"
+# Don't try gcc -ansi; that turns off useful extensions and
+# breaks some systems' header files.
+# AIX -qlanglvl=ansi
+# Ultrix and OSF/1 -std1
+# HP-UX -Aa
+# SVR4 -Xc
+for ac_arg in "" -qlanglvl=ansi -std1 -Aa -Xc
+do
+ CFLAGS="$ac_save_CFLAGS $ac_arg"
+dnl Don't use CPP directly in case it doesn't take these options.
+ AC_TRY_LINK(,
+[#if !defined(__STDC__) || __STDC__ != 1
+notansi(); /* Produce a link error if not ANSI C. */
+#endif
+], [ac_cv_prog_cc_ansi=$ac_arg; break])
+done
+CFLAGS="$ac_save_CFLAGS"
+])
+AC_MSG_RESULT($ac_cv_prog_cc_ansi)
+test "$ac_cv_prog_cc_ansi" != no && CC="$CC $ac_cv_prog_cc_ansi"
+])
+
AC_DEFUN(AC_PROG_CC_C_O,
[if test "x$CC" != xcc; then
AC_MSG_CHECKING(whether $CC and cc understand -c and -o together)
[AC_OBSOLETE([$0],
[; instead use AC_CHECK_HEADERS(string.h) and HAVE_STRING_H])dnl
AC_MSG_CHECKING([for BSD string and memory functions])
-AC_TRY_LINK([#include <strings.h>], [rindex(0, 0); bzero(0, 0);], ,
+AC_TRY_LINK([#include <strings.h>], [rindex(0, 0); bzero(0, 0);],
[AC_MSG_RESULT(yes); AC_DEFINE(USG)], [AC_MSG_RESULT(no)])])
[ac_header_dirent=no
AC_CHECK_HEADERS_DIRENT(dirent.h sys/ndir.h sys/dir.h ndir.h,
[ac_header_dirent=$ac_hdr; break])
+# Two versions of opendir et al. are in -ldir and -lx on SCO Xenix,
+# and -lx contains other useful things as well. (FIXME what are they?)
+if test $ac_header_dirent = dirent.h; then
+AC_CHECK_LIB(dir, opendir, LIBS="$LIBS -ldir")
+fi
+AC_CHECK_LIB(x, main, LIBS="$LIBS -lx")
])
dnl Like AC_CHECK_HEADER, except also make sure that HEADER-FILE
AC_DEFINE_UNQUOTED(${ac_tr_hdr}) $2])dnl
done])
-AC_DEFUN(AC_FUNC_CLOSEDIR_VOID,
-[AC_REQUIRE([AC_HEADER_DIRENT])dnl
-AC_MSG_CHECKING(whether closedir returns void)
-AC_CACHE_VAL(ac_cv_func_closedir_void,
-[AC_TRY_RUN([#include <sys/types.h>
-#include <$ac_header_dirent>
-int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
- ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
-AC_MSG_RESULT($ac_cv_func_closedir_void)
-if test $ac_cv_func_closedir_void = yes; then
- AC_DEFINE(CLOSEDIR_VOID)
-fi
-])
-
dnl Obsolete.
AC_DEFUN(AC_DIR_HEADER,
[ac_header_dirent=no
dnl ### Checks for functions
+AC_DEFUN(AC_FUNC_CLOSEDIR_VOID,
+[AC_REQUIRE([AC_HEADER_DIRENT])dnl
+AC_MSG_CHECKING(whether closedir returns void)
+AC_CACHE_VAL(ac_cv_func_closedir_void,
+[AC_TRY_RUN([#include <sys/types.h>
+#include <$ac_header_dirent>
+int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
+ ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
+AC_MSG_RESULT($ac_cv_func_closedir_void)
+if test $ac_cv_func_closedir_void = yes; then
+ AC_DEFINE(CLOSEDIR_VOID)
+fi
+])
+
AC_DEFUN(AC_FUNC_MMAP,
[AC_MSG_CHECKING(for working mmap)
AC_CACHE_VAL(ac_cv_func_mmap,
fi
])
+AC_DEFUN(AC_FUNC_GETMNTENT,
+[# getmntent is in -lsun on Irix 4, -lseq on PTX.
+AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
+AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
+AC_CHECK_FUNC(getmntent, [AC_DEFINE(HAVE_GETMNTENT)])])
+
+AC_DEFUN(AC_FUNC_STRFTIME,
+[# strftime is in -lintl on SCO UNIX.
+AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
+AC_CHECK_FUNC(strftime, [AC_DEFINE(HAVE_STRFTIME)])])
+
dnl ### Checks for structure members
])
AC_DEFUN(AC_INT_16_BITS,
-[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(int)])
+[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(int)])dnl
AC_MSG_CHECKING(whether int is 16 bits)
AC_TRY_RUN([main() { exit(sizeof(int) != 2); }],
[AC_MSG_RESULT(yes)
])
AC_DEFUN(AC_LONG_64_BITS,
-[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(long)])
+[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(long)])dnl
AC_MSG_CHECKING(whether long int is 64 bits)
AC_TRY_RUN([main() { exit(sizeof(long int) != 8); }],
[AC_MSG_RESULT(yes)
# msh@cis.ufl.edu says -lnsl (and -lsocket) are needed for his 386/AT,
# to get the SysV transport functions.
- # Not sure which flavor of 386 Unix this is, but it seems harmless to
+ # Not sure which flavor of 386 UNIX this is, but it seems harmless to
# check for it.
AC_CHECK_LIB(nsl, t_accept, [X_EXTRA_LIBS="$X_EXTRA_LIBS -lnsl"])
[AC_BEFORE([$0], [AC_TRY_LINK])dnl
AC_BEFORE([$0], [AC_TRY_RUN])dnl
AC_CHECK_HEADER(minix/config.h, MINIX=yes, MINIX=)
-# The Minix shell can not assign to the same variable on the same line!
if test "$MINIX" = yes; then
AC_DEFINE(_POSIX_SOURCE)
AC_DEFINE(_POSIX_1_SOURCE, 2)
fi
])
-AC_DEFUN(AC_OS_XENIX,
-[AC_REQUIRE([AC_DIR_HEADER])dnl
+AC_DEFUN(AC_XENIX_DIR,
+[AC_OBSOLETE([$0], [; instead use AC_HEADER_DIRENT])dnl
+AC_REQUIRE([AC_DIR_HEADER])dnl
AC_MSG_CHECKING(for Xenix)
AC_EGREP_CPP(yes,
[#if defined(M_XENIX) && !defined(M_UNIX)
#endif
], [AC_MSG_RESULT(yes); XENIX=yes], [AC_MSG_RESULT(no); XENIX=])
if test "$XENIX" = yes; then
+ # Make sure -ldir precedes -lx.
+ test $ac_header_dirent = dirent.h && LIBS="$LIBS -ldir"
LIBS="$LIBS -lx"
- if test $ac_header_dirent != sys/ndir.h; then
- LIBS="-ldir $LIBS" # Make sure -ldir precedes -lx.
- fi
fi
])
-AC_DEFUN(AC_OS_SCO,
-[AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
+AC_DEFUN(AC_DYNIX_SEQ,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_GETMNTENT])dnl
+AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
])
-AC_DEFUN(AC_OS_IRIX,
-[AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
+AC_DEFUN(AC_IRIX_SUN,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_GETMNTENT])dnl
+AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
])
-AC_DEFUN(AC_OS_DYNIX,
-[AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
+AC_DEFUN(AC_SCO_INTL,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_STRFTIME])dnl
+AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
])
* Testing Values and Files:: Checking strings and files.
* Multiple Cases:: Tests for several possible values.
* Defining Symbols:: Defining C preprocessor symbols.
-* Setting Variables:: Setting shell and output variables.
+* Setting Variables:: Setting variables in output files.
* Printing Messages:: Notifying users of progress or problems.
* Language Choice:: Selecting which language to use for testing.
split the Chaos into Land and Water; it takes a hell of an
engineer to handle that big amount of mud, and orderly separation
of solids from liquids@dots{} The computer scientist shouted: And
-the Chaos, where do you think it was it coming from, hmm?
+the Chaos, where do you think it was coming from, hmm?
---Anonymous
@end display
@code{configure} scripts are given the same command line options that
were given to this @code{configure} script, with minor changes if needed
(e.g., to adjust a relative path for the cache file or source
-directory). This macro also sets the shell and output variable
+directory). This macro also sets the output variable
@code{subdirs} to the list of directories @samp{@var{dir} @dots{}}.
@file{Makefile} rules can use this variable to determine which
subdirectories to recurse into.
@node Transforming Names, Versions, Package Options, Operation
@section Transforming Program Names When Installing
-Autoconf supports giving @code{configure} the following command line
-options to change the names of programs being installed:
+Autoconf supports giving @code{configure} command line options to change
+the names of programs being installed. These transformations are useful
+with programs that can be part of a cross-compilation development
+environment. For example, a cross-assembler running on a Sun 4
+configured with @samp{--target=i960-vxworks} is normally installed as
+@file{i960-vxworks-as}, rather than @file{as}, which could be confused
+with a native Sun 4 assembler.
+
+You can also force a program name to begin with @file{g}, if you don't
+want GNU programs installed on your system to shadow system programs by
+the same name. For example, if GNU @code{make} used this mechanism, you
+could configure it with @samp{--program-prefix=g} and when you ran
+@samp{make install}, it would be installed as
+@file{/usr/local/bin/gmake}.
+
+The @code{configure} options are:
@table @code
@item --program-prefix=@var{prefix}
append @var{suffix} to the names;
@item --program-transform-name=@var{expression}
-perform @code{sed} substitution @var{expression} on the names. The main
-use for this option is to prevent the automatic addition of a target
-name prefix to program names (see below) by giving an empty
-@var{expression}. As another possibility,
-@samp{--program-transform-name='s,^\(........\).*,\1.exe,'} could be used to
-truncate installed program names to 8 characters and append @file{.exe}.
+perform @code{sed} substitution @var{expression} on the names. For
+example, you could use
+@example
+--program-transform-name='s/^/g/; s/^gg/g/; s/^gless/less/'
+@end example
+@noindent
+to prepend a @samp{g} to most of the program names in a source tree,
+excepting those like @code{gdb} that already have one and those like
+@code{less} and @code{lesskey} that aren't GNU programs. (That is
+assuming that you have a source tree containing those programs that is
+set up to use this option.)
@end table
-In order to use the values given to those options, @file{configure.in}
+In order to use the values given to these options, @file{configure.in}
must call the macro @code{AC_ARG_PROGRAM}.
@defmac AC_ARG_PROGRAM
@maindex ARG_PROGRAM
@ovindex program_transform_name
-Place in output variable @code{program_transform_name} a
-sequence of @code{sed} commands for changing the names of installed
-programs.
+Place in output variable @code{program_transform_name} a sequence of
+@code{sed} commands for changing the names of installed programs.
If any of the above options are given to @code{configure}, program names
are transformed accordingly. Otherwise, if @code{AC_CANONICAL_SYSTEM}
the host type (specified with @samp{--host} or defaulted by
@code{config.sub}), the target type followed by a dash is used as a
prefix. Otherwise, no program name transformation is done.
+@end defmac
-These transformations are useful with programs that can be part of a
-cross-compilation development environment. For example, a
-cross-assembler running on a Sun 4 configured with
-@samp{--target=i960-vxworks} is normally installed as
-@file{i960-vxworks-as}, rather than @file{as}, which could be confused
-with a native Sun 4 assembler.
-
-They can also force a program name to begin with @file{g}, if you don't
-want GNU programs installed on your system to shadow system programs by
-the same name. For example, if GNU @code{make} used this macro, you
-could configure it with @samp{--program-prefix=g} and when you ran
-@samp{make install}, it would be installed as
-@file{/usr/local/bin/gmake}.
-
-Use the variable @code{program_transform_name} as in this example for
-an assembler, compiled as @file{as.new}. The shell variable @code{t}
-is needed in case @code{program_transform_name} contains any shell
-special characters. With quoting and variable substitutions, whitespace
-still properly separates @code{sed} arguments, but other special
-characters have no effect.
+Here is how to use the variable @code{program_transform_name} in a
+@file{Makefile.in}:
@example
-program_transform_name=@@program_transform_name@@
+tn=@@program_transform_name@@
install: all
- name=`t='$(program_transform_name)'; echo as | sed $$t` ; \
- $(INSTALL_PROGRAM) as.new $(bindir)/$$name
+ $(INSTALL_PROGRAM) myprog $(bindir)/`echo myprog|sed '$(tn)'`
@end example
-@end defmac
+@noindent
+If you have more than one program to install, you can do it in a loop:
+
+@example
+PROGRAMS=cat ls rm
+install:
+ for p in $(PROGRAMS); do \
+ $(INSTALL_PROGRAM) $$p $(bindir)/`echo $$p|sed '$(tn)'`; \
+ done
+@end example
@node Versions, , Transforming Names, Operation
@section Controlling Autoconf Versions
header file, depending on whether @code{AC_CONFIG_HEADER} has been
called. @xref{Output}, for more information on @code{AC_CONFIG_HEADER}.
-Within each section below, the macros are listed in alphabetical order.
-The macros are generally named for the output variables or C
-preprocessor macros that they define; those names are based largely on
-what existing GNU programs use.
-
@menu
* Alternative Programs:: Selecting between alternative programs.
* Libraries:: Library archives that might be missing.
simultaneously, define @code{NO_MINUS_C_MINUS_O}.
@end defmac
+@defmac AC_PROG_CC_ANSI
+@maindex PROG_CC_ANSI
+@ovindex CC
+If the C compiler in not in ANSI C mode by default (it does not define
+@code{__STDC__} to be 1), try to add an option to output variable
+@code{CC} to make it so. This macro tries various options that select
+ANSI C on some system or another.
+@end defmac
+
@defmac AC_PROG_CPP
@maindex PROG_CPP
@ovindex CPP
-Set shell and output variable @code{CPP} to a command that runs the
+Set output variable @code{CPP} to a command that runs the
C preprocessor. If @samp{$CC -E} doesn't work, it uses @file{/lib/cpp}.
It is only portable to run @code{CPP} on files with a @file{.c}
extension.
@defmac AC_PROG_CXXCPP
@maindex PROG_CXXCPP
@ovindex CXXCPP
-Set shell and output variable @code{CXXCPP} to a command that runs the
+Set output variable @code{CXXCPP} to a command that runs the
C++ preprocessor. If @samp{$CXX -E} doesn't work, it uses @file{/lib/cpp}.
It is only portable to run @code{CXXCPP} on files with a @file{.c},
@file{.C}, or @file{.cc} extension.
@maindex PROG_LN_S
@ovindex LN_S
If @samp{ln -s} works on the current filesystem (the operating system
-and filesystem support symbolic links), set shell and output
+and filesystem support symbolic links), set output
variable @code{LN_S} to @samp{ln -s}, otherwise set it to @samp{ln}.
@end defmac
header file is found. This macro and the names it defines are
considered obsolete. The names it defines are:
+@c The printed table looks too spaced out with blank lines between the entries.
@table @file
@item dirent.h
@code{DIRENT}
-
@item sys/ndir.h
@code{SYSNDIR}
-
@item sys/dir.h
@code{SYSDIR}
-
@item ndir.h
@code{NDIR}
@end table
Check for the following header files, and for the first one that is
found and defines @samp{DIR}, define the listed C preprocessor macro:
+@c The printed table looks too spaced out with blank lines between the entries.
@table @file
@item dirent.h
@code{HAVE_DIRENT_H}
-
@item sys/ndir.h
@code{HAVE_SYS_NDIR_H}
-
@item sys/dir.h
@code{HAVE_SYS_DIR_H}
-
@item ndir.h
@code{HAVE_NDIR_H}
@end table
The directory library declarations in the source code should look
-something like the following, which assumes that you have also called
-@samp{AC_CHECK_HEADERS(unistd.h)}:
+something like the following:
@example
@group
-#ifdef HAVE_UNISTD_H
-# include <sys/types.h>
-# include <unistd.h>
-#endif
-
-#ifdef HAVE_DIRENT_H
+#if HAVE_DIRENT_H
# include <dirent.h>
# define NAMLEN(dirent) (strlen((dirent)->d_name))
#else
# define dirent direct
# define NAMLEN(dirent) ((dirent)->d_namlen)
-# ifdef HAVE_SYS_NDIR_H
+# if HAVE_SYS_NDIR_H
# include <sys/ndir.h>
# endif
-# ifdef HAVE_SYS_DIR_H
+# if HAVE_SYS_DIR_H
# include <sys/dir.h>
# endif
-# ifdef HAVE_NDIR_H
+# if HAVE_NDIR_H
# include <ndir.h>
# endif
#endif
type @code{struct dirent}, not @code{struct direct}, and would access
the length of a directory entry name by passing a pointer to a
@code{struct dirent} to the @code{NAMLEN} macro.
+
+This macro also checks for the SCO Xenix @file{dir} and @file{x} libraries.
@end defmac
@defmac AC_HEADER_MAJOR
@code{GETLOADAVG_PRIVILEGED}.
@item
-This macro always defines @code{NEED_SETGID}, for @code{make}. The
-value is @samp{true} if special installation is required, @samp{false}
-if not. If @code{NEED_SETGID} is @samp{true}, it sets @code{KMEM_GROUP}
+This macro sets the output variable @code{NEED_SETGID}. The value is
+@samp{true} if special installation is required, @samp{false} if not.
+If @code{NEED_SETGID} is @samp{true}, this macro sets @code{KMEM_GROUP}
to the name of the group that should own the installed program.
@end enumerate
@end defmac
+@defmac AC_FUNC_GETMNTENT
+@maindex FUNC_GETMNTENT
+@cvindex HAVE_GETMNTENT
+Check for the @code{getmntent} in the @file{sun} and @file{seq}
+libraries, for Irix 4 and PTX, respectively. Then, if @code{getmntent} is
+available, define @code{HAVE_GETMNTENT}.
+@end defmac
+
@defmac AC_FUNC_MMAP
@maindex FUNC_MMAP
@cvindex HAVE_MMAP
definitions of @code{strcoll}, which should not be used.
@end defmac
+@defmac AC_FUNC_STRFTIME
+@maindex FUNC_STRFTIME
+@cvindex HAVE_STRFTIME
+Check for @code{strftime} in the @file{intl} library, for SCO UNIX.
+Then, if @code{strftime} is available, define @code{HAVE_STRFTIME}.
+@end defmac
+
@defmac AC_FUNC_UTIME_NULL
@maindex FUNC_UTIME_NULL
@cvindex HAVE_UTIME_NULL
@code{HAVE_SYS_TIME_H}.
@example
-#ifdef TIME_WITH_SYS_TIME
+#if TIME_WITH_SYS_TIME
# include <sys/time.h>
# include <time.h>
#else
-# ifdef HAVE_SYS_TIME_H
+# if HAVE_SYS_TIME_H
# include <sys/time.h>
# else
# include <time.h>
declarations.)
@end defmac
-@defmac AC_C_CROSS
-@maindex C_CROSS
-If the C compiler being used does not produce executables that can run
-on the system where @code{configure} is being run, set the shell
-variable @code{cross_compiling} to @samp{yes}, otherwise @samp{no}.
-This information can be used by @code{AC_TRY_RUN} to determine whether
-to take a default action instead of trying to run a test program
-For more information on dealing with test programs and
-cross-compiling, @xref{Test Programs}.
-@end defmac
-
@defmac AC_C_INLINE
@maindex C_INLINE
@cvindex inline
be replaced by a more systematic approach, based either on the
functions they make available or the environments they provide.
+@defmac AC_DYNIX_SEQ
+@maindex OS_DYNIX_SEQ
+If on PTX (Sequent UNIX), add @samp{-lseq} to output
+variable @code{LIBS}. This macro is obsolete; instead, use
+@code{AC_FUNC_GETMNTENT}.
+@end defmac
+
+@defmac AC_IRIX_SUN
+@maindex IRIX_SUN
+If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to output variable
+@code{LIBS}. This macro is obsolete; instead, use
+@code{AC_FUNC_GETMNTENT}.
+@end defmac
+
+@defmac AC_SCO_INTL
+@maindex SCO_INTL
+@ovindex LIBS
+If on SCO UNIX, add @samp{-lintl} to output variable @code{LIBS}.
+This macro is obsolete; instead, use @code{AC_FUNC_STRFTIME}.
+@end defmac
+
@defmac AC_OS_AIX
@maindex OS_AIX
@cvindex _ALL_SOURCE
functions. Should be called before any macros that run the C compiler.
@end defmac
-@defmac AC_OS_DYNIX
-@maindex OS_DYNIX
-If on DYNIX/ptx (Sequent UNIX), add @samp{-lseq} to output
-variable @code{LIBS}. Allows use of some BSD system calls and
-@code{getmntent}.
-@end defmac
-
-@defmac AC_OS_IRIX
-@maindex OS_IRIX
-If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to output
-variable @code{LIBS}. Needed to get @code{getmntent}. At sites using
-Yellow Pages/NIS, it is also needed to get properly working
-@code{gethostby*}, @code{getpw*}, @code{getgr*}, @code{getnetby*}, and
-so on.
-@c (According to Garrett.Wollman@uvm.edu.)
-@end defmac
-
@defmac AC_OS_ISC
@maindex OS_ISC
@cvindex _POSIX_SOURCE
facilities. Should be called before any macros that run the C compiler.
@end defmac
-@defmac AC_OS_SCO
-@maindex OS_SCO
-@ovindex LIBS
-If on SCO UNIX, add @samp{-lintl} to output variable @code{LIBS}.
-Used to get @code{strftime}. It must be called before checking for
-@code{strftime}.
-@end defmac
-
-@defmac AC_OS_XENIX
-@maindex OS_XENIX
+@defmac AC_XENIX_DIR
+@maindex XENIX_DIR
@ovindex LIBS
-If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also,
-if @file{sys/ndir.h} is not being used, add @samp{-ldir} to @code{LIBS}.
-Needed when using the directory reading functions. This macro calls
-@code{AC_DIR_HEADER} if it has not been called already.
+If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also, if
+@file{dirent.h} is being used, add @samp{-ldir} to @code{LIBS}. This
+macro calls @code{AC_DIR_HEADER} if it hasn't been called already. It
+is obsolete; use @code{AC_HEADER_DIRENT} instead.
@end defmac
@node Makefiles, Writing Tests, Existing Tests, Top
* Testing Values and Files:: Checking strings and files.
* Multiple Cases:: Tests for several possible values.
* Defining Symbols:: Defining C preprocessor symbols.
-* Setting Variables:: Setting shell and output variables.
+* Setting Variables:: Setting variables in output files.
* Printing Messages:: Notifying users of progress or problems.
* Language Choice:: Selecting which language to use for testing.
@end menu
this warning message.
@end defmac
+@defmac AC_C_CROSS
+@maindex C_CROSS
+If the C compiler being used does not produce executables that can run
+on the system where @code{configure} is being run, set the shell
+variable @code{cross_compiling} to @samp{yes}, otherwise @samp{no}.
+@end defmac
+
@menu
* Alternatives:: Approaches preferred over test programs.
* Guidelines:: General rules for writing test programs.
@section Setting Variables
These macros help other macros to define variables that are used in the
-@code{configure} shell script and substituted into output files.
+@code{configure} shell script and substituted into output files. These
+variables are called @dfn{output variables}.
@defmac AC_SUBST (@var{variable})
@maindex SUBST
-Substitute the variable @var{variable} when creating the output files
-(typically one or more @file{Makefile}s). This means replace instances
-of @samp{@@@var{variable}@@}, e.g. in @file{Makefile.in}, with the
-current value of the shell variable @var{variable}. The value of
-@var{variable} should not contain literal newlines. If this macro were
-not called, the value of @var{variable} would not be set in the output
-files, even though @code{configure} had figured out a value for it.
-
-You can set or add to the value of @var{variable} in the usual shell
-way. For example, to add @samp{-ltermcap} to the value of the variable
-@code{LIBS}:
-
-@example
-LIBS="$LIBS -ltermcap"
-@end example
+Substitute the variable @var{variable} into output files (typically one
+or more @file{Makefile}s). This means that @code{AC_OUTPUT} will
+replace instances of @samp{@@@var{variable}@@}, e.g. in
+@file{Makefile.in}, with the value that the shell variable
+@var{variable} has when @code{AC_OUTPUT} is called. The value of
+@var{variable} should not contain literal newlines.
@end defmac
@defmac AC_SUBST_FILE (@var{variable})
@maindex SUBST_FILE
Substitute the contents of the file named by shell variable
-@var{variable} into output variable @var{variable} when
-creating the output files (typically one or more @file{Makefile}s).
-This macro is useful for inserting @file{Makefile} fragments containing
-special dependencies or other @code{make} directives for particular host
-or target types into @file{Makefile}s.
+@var{variable} into output files (typically one or more
+@file{Makefile}s). This macro is useful for inserting @file{Makefile}
+fragments containing special dependencies or other @code{make}
+directives for particular host or target types into @file{Makefile}s.
For example, @file{configure.in} could contain:
A sample call is:
@example
-AC_OBSOLETE([$0], [; use AC_CHECK_HEADERS(unistd.h) instead])
+AC_OBSOLETE([$0], [; use AC_CHECK_HEADERS(unistd.h) instead])dnl
@end example
@end defmac
@node Canonicalizing, System Name Variables, Specifying Names, Manual Configuration
@section Getting the Canonical System Type
-The following macros make the name of the system type available in
-@code{configure} scripts.
+The following macros make the system type available to @code{configure}
+scripts. They run the shell script @code{config.guess} to determine any
+values for the host, target, and build types that they need and the user
+did not specify on the command line. They run @code{config.sub} to
+canonicalize any aliases the user gave. If you use these macros, you
+must distribute those two shell scripts along with your source code.
+@xref{Output}, for information about the @code{AC_CONFIG_AUX_DIR} macro
+which you can use to control which directory @code{configure} looks for
+those scripts in. If you do not use either of these macros,
+@code{configure} ignores any @samp{--host}, @samp{--target}, and
+@samp{--build} options given to it.
@defmac AC_CANONICAL_HOST
@maindex CANONICAL_HOST
@defmac AC_CANONICAL_SYSTEM
@maindex CANONICAL_SYSTEM
-Set shell and output variables to the names of the canonical system
-types. If the user did not specify one or more of those values on the
-command line, run @code{config.guess} to determine them. Run
-@code{config.sub} to canonicalize any aliases the user gave. If you use
-this macro, you must distribute those two shell scripts along with your
-source code (@pxref{Output}, for information about the
-@code{AC_CONFIG_AUX_DIR} macro which you can use to control which
-directory @code{configure} looks for those scripts in). If you do not
-run this macro, @code{configure} ignores any @samp{--host}, etc. options
-given to it.
+Set output variables to the names of the canonical system
+types.
@end defmac
@node System Name Variables, Using System Type, Canonicalizing, Manual Configuration
@section System Name Variables
After calling @code{AC_CANONICAL_SYSTEM} or @code{AC_CANONICAL_HOST},
-the shell and output variables that contain the system type
-information are:
+the output variables that contain the system type information are:
@table @code
@ovindex build
If you are cross-compiling, it is impossible to check features that
require running a test program. You could ``prime the cache'' by
setting those values correctly for that system in
-@file{@var{exec_prefix}/lib/config.site}. The cache file is careful to
-not override any variables set in the site files. Similarly, you should
-not override command-line options in the site files. Your code should
-check that variables such as @code{prefix} and @code{cache_file} have
-their default values (as set near the top of @code{configure}) before
-changing them.
+@file{@var{exec_prefix}/lib/config.site}. To find out the names of the
+cache variables you need to set, look for shell variables with
+@samp{_cv_} in their names in the affected configure scripts, or in the
+Autoconf @code{m4} source code for those macros.
+
+The cache file is careful to not override any variables set in the site
+files. Similarly, you should not override command-line options in the
+site files. Your code should check that variables such as @code{prefix}
+and @code{cache_file} have their default values (as set near the top of
+@code{configure}) before changing them.
Here is a sample file @file{/usr/share/local/gnu/lib/config.site}.
-@samp{configure --prefix=/usr/share/local/gnu} would read this file.
+@samp{configure --prefix=/usr/share/local/gnu} would read this file
+(if @code{CONFIG_SITE} is not set).
@example
# config.site for configure
of those variables in the environment when @code{configure} is run.
Doing this isn't necessary, but it's a convenience for users.
+Add @file{config.log} and @file{config.cache} to the list of files you
+remove in @code{distclean} targets.
+
If you have the following in @file{Makefile.in}:
@example
predictably, and does not treat quotes (except backquotes) specially.
@xref{Setting Variables}.
+All of the boolean shell variables set by Autoconf macros now use
+@samp{yes} for the true value. Most of them use @samp{no} for false,
+though for backward compatibility some use the empty string instead. If
+you were relying on a shell variable being set to something like 1 or
+@samp{t} for true, you need to change your tests.
+
@node Changed Macro Writing, , Changed Results, Upgrading
@section Changed Macro Writing
@item AC_CROSS_CHECK
@maindex CROSS_CHECK
@code{AC_C_CROSS}
-@item AC_DYNIX_SEQ
-@maindex DYNIX_SEQ
-@code{AC_OS_DYNIX}
@item AC_ERROR
@maindex ERROR
@code{AC_MSG_ERROR}
@item AC_INLINE
@maindex INLINE
@code{AC_C_INLINE}
-@item AC_IRIX_SUN
-@maindex IRIX_SUN
-@code{AC_OS_IRIX}
@item AC_ISC_POSIX
@maindex ISC_POSIX
@code{AC_OS_ISC}
@item AC_RSH
@maindex RSH
removed because of limited usefulness
-@item AC_SCO_INTL
-@maindex SCO_INTL
-@code{AC_OS_SCO}
@item AC_SETVBUF_REVERSED
@maindex SETVBUF_REVERSED
@code{AC_FUNC_SETVBUF_REVERSED}
@item AC_WORDS_BIGENDIAN
@maindex WORDS_BIGENDIAN
@code{AC_C_BIGENDIAN}
-@item AC_XENIX_DIR
-@maindex XENIX_DIR
-@code{AC_OS_XENIX}
@item AC_YYTEXT_POINTER
@maindex YYTEXT_POINTER
@code{AC_DECL_YYTEXT}
include(acgeneral.m4)dnl
builtin(include, acspecific.m4)dnl
builtin(include, acoldnames.m4)dnl
-dnl
-dnl These are the alternate definitions of the acgeneral.m4 macros we want to
-dnl redefine. They produce strings in the output marked with "@@@" so we can
-dnl easily extract the information we want. The `#' at the end of the first
-dnl line of each definition seems to be necessary to prevent m4 from eating
-dnl the newline, which makes the @@@ not always be at the beginning of a line.
-dnl
+
+dnl These are alternate definitions of some macros, which produce
+dnl strings in the output marked with "@@@" so we can easily extract
+dnl the information we want. The `#' at the end of the first line of
+dnl each definition seems to be necessary to prevent m4 from eating
+dnl the newline, which makes the @@@ not always be at the beginning of
+dnl a line.
+
define([AC_DEFINE],[#
@@@syms="$syms $1"@@@
-])dnl
+])
define([AC_DEFINE_UNQUOTED],[#
@@@syms="$syms $1"@@@
-])dnl
+])
define([AC_SIZEOF_TYPE],[#
@@@types="$types,$1"@@@
-])dnl
+])
define([AC_CHECK_FUNCS],[#
@@@funcs="$funcs $1"@@@
-])dnl
+])
define([AC_CHECK_HEADERS],[#
@@@headers="$headers $1"@@@
-])dnl
+])
+define([AC_CHECK_HEADERS_DIRENT],[#
+@@@headers="$headers $1"@@@
+])
define([AC_CONFIG_HEADER],[#
@@@config_h=$1@@@
-])dnl
+])
define([AC_CHECK_LIB], [#
changequote(/,/)dnl
define(/libname/, dnl
# If it was not found, we do:
$4
])
-])dnl
-dnl
+])
* Testing Values and Files:: Checking strings and files.
* Multiple Cases:: Tests for several possible values.
* Defining Symbols:: Defining C preprocessor symbols.
-* Setting Variables:: Setting shell and output variables.
+* Setting Variables:: Setting variables in output files.
* Printing Messages:: Notifying users of progress or problems.
* Language Choice:: Selecting which language to use for testing.
split the Chaos into Land and Water; it takes a hell of an
engineer to handle that big amount of mud, and orderly separation
of solids from liquids@dots{} The computer scientist shouted: And
-the Chaos, where do you think it was it coming from, hmm?
+the Chaos, where do you think it was coming from, hmm?
---Anonymous
@end display
@code{configure} scripts are given the same command line options that
were given to this @code{configure} script, with minor changes if needed
(e.g., to adjust a relative path for the cache file or source
-directory). This macro also sets the shell and output variable
+directory). This macro also sets the output variable
@code{subdirs} to the list of directories @samp{@var{dir} @dots{}}.
@file{Makefile} rules can use this variable to determine which
subdirectories to recurse into.
@node Transforming Names, Versions, Package Options, Operation
@section Transforming Program Names When Installing
-Autoconf supports giving @code{configure} the following command line
-options to change the names of programs being installed:
+Autoconf supports giving @code{configure} command line options to change
+the names of programs being installed. These transformations are useful
+with programs that can be part of a cross-compilation development
+environment. For example, a cross-assembler running on a Sun 4
+configured with @samp{--target=i960-vxworks} is normally installed as
+@file{i960-vxworks-as}, rather than @file{as}, which could be confused
+with a native Sun 4 assembler.
+
+You can also force a program name to begin with @file{g}, if you don't
+want GNU programs installed on your system to shadow system programs by
+the same name. For example, if GNU @code{make} used this mechanism, you
+could configure it with @samp{--program-prefix=g} and when you ran
+@samp{make install}, it would be installed as
+@file{/usr/local/bin/gmake}.
+
+The @code{configure} options are:
@table @code
@item --program-prefix=@var{prefix}
append @var{suffix} to the names;
@item --program-transform-name=@var{expression}
-perform @code{sed} substitution @var{expression} on the names. The main
-use for this option is to prevent the automatic addition of a target
-name prefix to program names (see below) by giving an empty
-@var{expression}. As another possibility,
-@samp{--program-transform-name='s,^\(........\).*,\1.exe,'} could be used to
-truncate installed program names to 8 characters and append @file{.exe}.
+perform @code{sed} substitution @var{expression} on the names. For
+example, you could use
+@example
+--program-transform-name='s/^/g/; s/^gg/g/; s/^gless/less/'
+@end example
+@noindent
+to prepend a @samp{g} to most of the program names in a source tree,
+excepting those like @code{gdb} that already have one and those like
+@code{less} and @code{lesskey} that aren't GNU programs. (That is
+assuming that you have a source tree containing those programs that is
+set up to use this option.)
@end table
-In order to use the values given to those options, @file{configure.in}
+In order to use the values given to these options, @file{configure.in}
must call the macro @code{AC_ARG_PROGRAM}.
@defmac AC_ARG_PROGRAM
@maindex ARG_PROGRAM
@ovindex program_transform_name
-Place in output variable @code{program_transform_name} a
-sequence of @code{sed} commands for changing the names of installed
-programs.
+Place in output variable @code{program_transform_name} a sequence of
+@code{sed} commands for changing the names of installed programs.
If any of the above options are given to @code{configure}, program names
are transformed accordingly. Otherwise, if @code{AC_CANONICAL_SYSTEM}
the host type (specified with @samp{--host} or defaulted by
@code{config.sub}), the target type followed by a dash is used as a
prefix. Otherwise, no program name transformation is done.
+@end defmac
-These transformations are useful with programs that can be part of a
-cross-compilation development environment. For example, a
-cross-assembler running on a Sun 4 configured with
-@samp{--target=i960-vxworks} is normally installed as
-@file{i960-vxworks-as}, rather than @file{as}, which could be confused
-with a native Sun 4 assembler.
-
-They can also force a program name to begin with @file{g}, if you don't
-want GNU programs installed on your system to shadow system programs by
-the same name. For example, if GNU @code{make} used this macro, you
-could configure it with @samp{--program-prefix=g} and when you ran
-@samp{make install}, it would be installed as
-@file{/usr/local/bin/gmake}.
-
-Use the variable @code{program_transform_name} as in this example for
-an assembler, compiled as @file{as.new}. The shell variable @code{t}
-is needed in case @code{program_transform_name} contains any shell
-special characters. With quoting and variable substitutions, whitespace
-still properly separates @code{sed} arguments, but other special
-characters have no effect.
+Here is how to use the variable @code{program_transform_name} in a
+@file{Makefile.in}:
@example
-program_transform_name=@@program_transform_name@@
+tn=@@program_transform_name@@
install: all
- name=`t='$(program_transform_name)'; echo as | sed $$t` ; \
- $(INSTALL_PROGRAM) as.new $(bindir)/$$name
+ $(INSTALL_PROGRAM) myprog $(bindir)/`echo myprog|sed '$(tn)'`
@end example
-@end defmac
+@noindent
+If you have more than one program to install, you can do it in a loop:
+
+@example
+PROGRAMS=cat ls rm
+install:
+ for p in $(PROGRAMS); do \
+ $(INSTALL_PROGRAM) $$p $(bindir)/`echo $$p|sed '$(tn)'`; \
+ done
+@end example
@node Versions, , Transforming Names, Operation
@section Controlling Autoconf Versions
header file, depending on whether @code{AC_CONFIG_HEADER} has been
called. @xref{Output}, for more information on @code{AC_CONFIG_HEADER}.
-Within each section below, the macros are listed in alphabetical order.
-The macros are generally named for the output variables or C
-preprocessor macros that they define; those names are based largely on
-what existing GNU programs use.
-
@menu
* Alternative Programs:: Selecting between alternative programs.
* Libraries:: Library archives that might be missing.
simultaneously, define @code{NO_MINUS_C_MINUS_O}.
@end defmac
+@defmac AC_PROG_CC_ANSI
+@maindex PROG_CC_ANSI
+@ovindex CC
+If the C compiler in not in ANSI C mode by default (it does not define
+@code{__STDC__} to be 1), try to add an option to output variable
+@code{CC} to make it so. This macro tries various options that select
+ANSI C on some system or another.
+@end defmac
+
@defmac AC_PROG_CPP
@maindex PROG_CPP
@ovindex CPP
-Set shell and output variable @code{CPP} to a command that runs the
+Set output variable @code{CPP} to a command that runs the
C preprocessor. If @samp{$CC -E} doesn't work, it uses @file{/lib/cpp}.
It is only portable to run @code{CPP} on files with a @file{.c}
extension.
@defmac AC_PROG_CXXCPP
@maindex PROG_CXXCPP
@ovindex CXXCPP
-Set shell and output variable @code{CXXCPP} to a command that runs the
+Set output variable @code{CXXCPP} to a command that runs the
C++ preprocessor. If @samp{$CXX -E} doesn't work, it uses @file{/lib/cpp}.
It is only portable to run @code{CXXCPP} on files with a @file{.c},
@file{.C}, or @file{.cc} extension.
@maindex PROG_LN_S
@ovindex LN_S
If @samp{ln -s} works on the current filesystem (the operating system
-and filesystem support symbolic links), set shell and output
+and filesystem support symbolic links), set output
variable @code{LN_S} to @samp{ln -s}, otherwise set it to @samp{ln}.
@end defmac
header file is found. This macro and the names it defines are
considered obsolete. The names it defines are:
+@c The printed table looks too spaced out with blank lines between the entries.
@table @file
@item dirent.h
@code{DIRENT}
-
@item sys/ndir.h
@code{SYSNDIR}
-
@item sys/dir.h
@code{SYSDIR}
-
@item ndir.h
@code{NDIR}
@end table
Check for the following header files, and for the first one that is
found and defines @samp{DIR}, define the listed C preprocessor macro:
+@c The printed table looks too spaced out with blank lines between the entries.
@table @file
@item dirent.h
@code{HAVE_DIRENT_H}
-
@item sys/ndir.h
@code{HAVE_SYS_NDIR_H}
-
@item sys/dir.h
@code{HAVE_SYS_DIR_H}
-
@item ndir.h
@code{HAVE_NDIR_H}
@end table
The directory library declarations in the source code should look
-something like the following, which assumes that you have also called
-@samp{AC_CHECK_HEADERS(unistd.h)}:
+something like the following:
@example
@group
-#ifdef HAVE_UNISTD_H
-# include <sys/types.h>
-# include <unistd.h>
-#endif
-
-#ifdef HAVE_DIRENT_H
+#if HAVE_DIRENT_H
# include <dirent.h>
# define NAMLEN(dirent) (strlen((dirent)->d_name))
#else
# define dirent direct
# define NAMLEN(dirent) ((dirent)->d_namlen)
-# ifdef HAVE_SYS_NDIR_H
+# if HAVE_SYS_NDIR_H
# include <sys/ndir.h>
# endif
-# ifdef HAVE_SYS_DIR_H
+# if HAVE_SYS_DIR_H
# include <sys/dir.h>
# endif
-# ifdef HAVE_NDIR_H
+# if HAVE_NDIR_H
# include <ndir.h>
# endif
#endif
type @code{struct dirent}, not @code{struct direct}, and would access
the length of a directory entry name by passing a pointer to a
@code{struct dirent} to the @code{NAMLEN} macro.
+
+This macro also checks for the SCO Xenix @file{dir} and @file{x} libraries.
@end defmac
@defmac AC_HEADER_MAJOR
@code{GETLOADAVG_PRIVILEGED}.
@item
-This macro always defines @code{NEED_SETGID}, for @code{make}. The
-value is @samp{true} if special installation is required, @samp{false}
-if not. If @code{NEED_SETGID} is @samp{true}, it sets @code{KMEM_GROUP}
+This macro sets the output variable @code{NEED_SETGID}. The value is
+@samp{true} if special installation is required, @samp{false} if not.
+If @code{NEED_SETGID} is @samp{true}, this macro sets @code{KMEM_GROUP}
to the name of the group that should own the installed program.
@end enumerate
@end defmac
+@defmac AC_FUNC_GETMNTENT
+@maindex FUNC_GETMNTENT
+@cvindex HAVE_GETMNTENT
+Check for the @code{getmntent} in the @file{sun} and @file{seq}
+libraries, for Irix 4 and PTX, respectively. Then, if @code{getmntent} is
+available, define @code{HAVE_GETMNTENT}.
+@end defmac
+
@defmac AC_FUNC_MMAP
@maindex FUNC_MMAP
@cvindex HAVE_MMAP
definitions of @code{strcoll}, which should not be used.
@end defmac
+@defmac AC_FUNC_STRFTIME
+@maindex FUNC_STRFTIME
+@cvindex HAVE_STRFTIME
+Check for @code{strftime} in the @file{intl} library, for SCO UNIX.
+Then, if @code{strftime} is available, define @code{HAVE_STRFTIME}.
+@end defmac
+
@defmac AC_FUNC_UTIME_NULL
@maindex FUNC_UTIME_NULL
@cvindex HAVE_UTIME_NULL
@code{HAVE_SYS_TIME_H}.
@example
-#ifdef TIME_WITH_SYS_TIME
+#if TIME_WITH_SYS_TIME
# include <sys/time.h>
# include <time.h>
#else
-# ifdef HAVE_SYS_TIME_H
+# if HAVE_SYS_TIME_H
# include <sys/time.h>
# else
# include <time.h>
declarations.)
@end defmac
-@defmac AC_C_CROSS
-@maindex C_CROSS
-If the C compiler being used does not produce executables that can run
-on the system where @code{configure} is being run, set the shell
-variable @code{cross_compiling} to @samp{yes}, otherwise @samp{no}.
-This information can be used by @code{AC_TRY_RUN} to determine whether
-to take a default action instead of trying to run a test program
-For more information on dealing with test programs and
-cross-compiling, @xref{Test Programs}.
-@end defmac
-
@defmac AC_C_INLINE
@maindex C_INLINE
@cvindex inline
be replaced by a more systematic approach, based either on the
functions they make available or the environments they provide.
+@defmac AC_DYNIX_SEQ
+@maindex OS_DYNIX_SEQ
+If on PTX (Sequent UNIX), add @samp{-lseq} to output
+variable @code{LIBS}. This macro is obsolete; instead, use
+@code{AC_FUNC_GETMNTENT}.
+@end defmac
+
+@defmac AC_IRIX_SUN
+@maindex IRIX_SUN
+If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to output variable
+@code{LIBS}. This macro is obsolete; instead, use
+@code{AC_FUNC_GETMNTENT}.
+@end defmac
+
+@defmac AC_SCO_INTL
+@maindex SCO_INTL
+@ovindex LIBS
+If on SCO UNIX, add @samp{-lintl} to output variable @code{LIBS}.
+This macro is obsolete; instead, use @code{AC_FUNC_STRFTIME}.
+@end defmac
+
@defmac AC_OS_AIX
@maindex OS_AIX
@cvindex _ALL_SOURCE
functions. Should be called before any macros that run the C compiler.
@end defmac
-@defmac AC_OS_DYNIX
-@maindex OS_DYNIX
-If on DYNIX/ptx (Sequent UNIX), add @samp{-lseq} to output
-variable @code{LIBS}. Allows use of some BSD system calls and
-@code{getmntent}.
-@end defmac
-
-@defmac AC_OS_IRIX
-@maindex OS_IRIX
-If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to output
-variable @code{LIBS}. Needed to get @code{getmntent}. At sites using
-Yellow Pages/NIS, it is also needed to get properly working
-@code{gethostby*}, @code{getpw*}, @code{getgr*}, @code{getnetby*}, and
-so on.
-@c (According to Garrett.Wollman@uvm.edu.)
-@end defmac
-
@defmac AC_OS_ISC
@maindex OS_ISC
@cvindex _POSIX_SOURCE
facilities. Should be called before any macros that run the C compiler.
@end defmac
-@defmac AC_OS_SCO
-@maindex OS_SCO
-@ovindex LIBS
-If on SCO UNIX, add @samp{-lintl} to output variable @code{LIBS}.
-Used to get @code{strftime}. It must be called before checking for
-@code{strftime}.
-@end defmac
-
-@defmac AC_OS_XENIX
-@maindex OS_XENIX
+@defmac AC_XENIX_DIR
+@maindex XENIX_DIR
@ovindex LIBS
-If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also,
-if @file{sys/ndir.h} is not being used, add @samp{-ldir} to @code{LIBS}.
-Needed when using the directory reading functions. This macro calls
-@code{AC_DIR_HEADER} if it has not been called already.
+If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also, if
+@file{dirent.h} is being used, add @samp{-ldir} to @code{LIBS}. This
+macro calls @code{AC_DIR_HEADER} if it hasn't been called already. It
+is obsolete; use @code{AC_HEADER_DIRENT} instead.
@end defmac
@node Makefiles, Writing Tests, Existing Tests, Top
* Testing Values and Files:: Checking strings and files.
* Multiple Cases:: Tests for several possible values.
* Defining Symbols:: Defining C preprocessor symbols.
-* Setting Variables:: Setting shell and output variables.
+* Setting Variables:: Setting variables in output files.
* Printing Messages:: Notifying users of progress or problems.
* Language Choice:: Selecting which language to use for testing.
@end menu
this warning message.
@end defmac
+@defmac AC_C_CROSS
+@maindex C_CROSS
+If the C compiler being used does not produce executables that can run
+on the system where @code{configure} is being run, set the shell
+variable @code{cross_compiling} to @samp{yes}, otherwise @samp{no}.
+@end defmac
+
@menu
* Alternatives:: Approaches preferred over test programs.
* Guidelines:: General rules for writing test programs.
@section Setting Variables
These macros help other macros to define variables that are used in the
-@code{configure} shell script and substituted into output files.
+@code{configure} shell script and substituted into output files. These
+variables are called @dfn{output variables}.
@defmac AC_SUBST (@var{variable})
@maindex SUBST
-Substitute the variable @var{variable} when creating the output files
-(typically one or more @file{Makefile}s). This means replace instances
-of @samp{@@@var{variable}@@}, e.g. in @file{Makefile.in}, with the
-current value of the shell variable @var{variable}. The value of
-@var{variable} should not contain literal newlines. If this macro were
-not called, the value of @var{variable} would not be set in the output
-files, even though @code{configure} had figured out a value for it.
-
-You can set or add to the value of @var{variable} in the usual shell
-way. For example, to add @samp{-ltermcap} to the value of the variable
-@code{LIBS}:
-
-@example
-LIBS="$LIBS -ltermcap"
-@end example
+Substitute the variable @var{variable} into output files (typically one
+or more @file{Makefile}s). This means that @code{AC_OUTPUT} will
+replace instances of @samp{@@@var{variable}@@}, e.g. in
+@file{Makefile.in}, with the value that the shell variable
+@var{variable} has when @code{AC_OUTPUT} is called. The value of
+@var{variable} should not contain literal newlines.
@end defmac
@defmac AC_SUBST_FILE (@var{variable})
@maindex SUBST_FILE
Substitute the contents of the file named by shell variable
-@var{variable} into output variable @var{variable} when
-creating the output files (typically one or more @file{Makefile}s).
-This macro is useful for inserting @file{Makefile} fragments containing
-special dependencies or other @code{make} directives for particular host
-or target types into @file{Makefile}s.
+@var{variable} into output files (typically one or more
+@file{Makefile}s). This macro is useful for inserting @file{Makefile}
+fragments containing special dependencies or other @code{make}
+directives for particular host or target types into @file{Makefile}s.
For example, @file{configure.in} could contain:
A sample call is:
@example
-AC_OBSOLETE([$0], [; use AC_CHECK_HEADERS(unistd.h) instead])
+AC_OBSOLETE([$0], [; use AC_CHECK_HEADERS(unistd.h) instead])dnl
@end example
@end defmac
@node Canonicalizing, System Name Variables, Specifying Names, Manual Configuration
@section Getting the Canonical System Type
-The following macros make the name of the system type available in
-@code{configure} scripts.
+The following macros make the system type available to @code{configure}
+scripts. They run the shell script @code{config.guess} to determine any
+values for the host, target, and build types that they need and the user
+did not specify on the command line. They run @code{config.sub} to
+canonicalize any aliases the user gave. If you use these macros, you
+must distribute those two shell scripts along with your source code.
+@xref{Output}, for information about the @code{AC_CONFIG_AUX_DIR} macro
+which you can use to control which directory @code{configure} looks for
+those scripts in. If you do not use either of these macros,
+@code{configure} ignores any @samp{--host}, @samp{--target}, and
+@samp{--build} options given to it.
@defmac AC_CANONICAL_HOST
@maindex CANONICAL_HOST
@defmac AC_CANONICAL_SYSTEM
@maindex CANONICAL_SYSTEM
-Set shell and output variables to the names of the canonical system
-types. If the user did not specify one or more of those values on the
-command line, run @code{config.guess} to determine them. Run
-@code{config.sub} to canonicalize any aliases the user gave. If you use
-this macro, you must distribute those two shell scripts along with your
-source code (@pxref{Output}, for information about the
-@code{AC_CONFIG_AUX_DIR} macro which you can use to control which
-directory @code{configure} looks for those scripts in). If you do not
-run this macro, @code{configure} ignores any @samp{--host}, etc. options
-given to it.
+Set output variables to the names of the canonical system
+types.
@end defmac
@node System Name Variables, Using System Type, Canonicalizing, Manual Configuration
@section System Name Variables
After calling @code{AC_CANONICAL_SYSTEM} or @code{AC_CANONICAL_HOST},
-the shell and output variables that contain the system type
-information are:
+the output variables that contain the system type information are:
@table @code
@ovindex build
If you are cross-compiling, it is impossible to check features that
require running a test program. You could ``prime the cache'' by
setting those values correctly for that system in
-@file{@var{exec_prefix}/lib/config.site}. The cache file is careful to
-not override any variables set in the site files. Similarly, you should
-not override command-line options in the site files. Your code should
-check that variables such as @code{prefix} and @code{cache_file} have
-their default values (as set near the top of @code{configure}) before
-changing them.
+@file{@var{exec_prefix}/lib/config.site}. To find out the names of the
+cache variables you need to set, look for shell variables with
+@samp{_cv_} in their names in the affected configure scripts, or in the
+Autoconf @code{m4} source code for those macros.
+
+The cache file is careful to not override any variables set in the site
+files. Similarly, you should not override command-line options in the
+site files. Your code should check that variables such as @code{prefix}
+and @code{cache_file} have their default values (as set near the top of
+@code{configure}) before changing them.
Here is a sample file @file{/usr/share/local/gnu/lib/config.site}.
-@samp{configure --prefix=/usr/share/local/gnu} would read this file.
+@samp{configure --prefix=/usr/share/local/gnu} would read this file
+(if @code{CONFIG_SITE} is not set).
@example
# config.site for configure
of those variables in the environment when @code{configure} is run.
Doing this isn't necessary, but it's a convenience for users.
+Add @file{config.log} and @file{config.cache} to the list of files you
+remove in @code{distclean} targets.
+
If you have the following in @file{Makefile.in}:
@example
predictably, and does not treat quotes (except backquotes) specially.
@xref{Setting Variables}.
+All of the boolean shell variables set by Autoconf macros now use
+@samp{yes} for the true value. Most of them use @samp{no} for false,
+though for backward compatibility some use the empty string instead. If
+you were relying on a shell variable being set to something like 1 or
+@samp{t} for true, you need to change your tests.
+
@node Changed Macro Writing, , Changed Results, Upgrading
@section Changed Macro Writing
@item AC_CROSS_CHECK
@maindex CROSS_CHECK
@code{AC_C_CROSS}
-@item AC_DYNIX_SEQ
-@maindex DYNIX_SEQ
-@code{AC_OS_DYNIX}
@item AC_ERROR
@maindex ERROR
@code{AC_MSG_ERROR}
@item AC_INLINE
@maindex INLINE
@code{AC_C_INLINE}
-@item AC_IRIX_SUN
-@maindex IRIX_SUN
-@code{AC_OS_IRIX}
@item AC_ISC_POSIX
@maindex ISC_POSIX
@code{AC_OS_ISC}
@item AC_RSH
@maindex RSH
removed because of limited usefulness
-@item AC_SCO_INTL
-@maindex SCO_INTL
-@code{AC_OS_SCO}
@item AC_SETVBUF_REVERSED
@maindex SETVBUF_REVERSED
@code{AC_FUNC_SETVBUF_REVERSED}
@item AC_WORDS_BIGENDIAN
@maindex WORDS_BIGENDIAN
@code{AC_C_BIGENDIAN}
-@item AC_XENIX_DIR
-@maindex XENIX_DIR
-@code{AC_OS_XENIX}
@item AC_YYTEXT_POINTER
@maindex YYTEXT_POINTER
@code{AC_DECL_YYTEXT}
if test -n "${program_transform_name}"; then
# Double any \ or $.
echo 's,\\,\\\\,g; s,\$,$$,g' > conftestsed
- program_transform_name="-e `echo ${program_transform_name} | sed -f conftestsed`"
+ program_transform_name="`echo ${program_transform_name}|sed -f conftestsed`"
rm -f conftestsed
fi
test "${program_prefix}" != NONE &&
- program_transform_name="-e s,^,${program_prefix}, ${program_transform_name}"
+ program_transform_name="s,^,${program_prefix},; ${program_transform_name}"
# Use a double $ so make ignores it.
test "${program_suffix}" != NONE &&
- program_transform_name="-e s,\$\$,${program_suffix}, ${program_transform_name}"
+ program_transform_name="s,\$\$,${program_suffix},; ${program_transform_name}"
# sed with no file args requires a program.
-test "${program_transform_name}" = "" && program_transform_name="-e s,x,x,"
+test "${program_transform_name}" = "" && program_transform_name="s,x,x,"
AC_SUBST(program_transform_name)dnl
])
*) AC_MSG_ERROR(can only configure for one host and one target at a time) ;;
esac
-# Make sure we can run config.sub.
-if ${ac_config_sub} sun4 >/dev/null 2>&1; then :
-else AC_MSG_ERROR(can not run ${ac_config_sub})
-fi
-
AC_CANONICAL_HOST
AC_CANONICAL_TARGET
AC_CANONICAL_BUILD
AC_DEFUN(AC_CANONICAL_HOST,
[AC_REQUIRE([AC_CONFIG_AUX_DIR_DEFAULT])dnl
+
+# Make sure we can run config.sub.
+if ${ac_config_sub} sun4 >/dev/null 2>&1; then :
+else AC_MSG_ERROR(can not run ${ac_config_sub})
+fi
+
AC_MSG_CHECKING(host system type)
host_alias=$host
AC_DEFUN(AC_LONG_FILE_NAMES, [indir([AC_SYS_LONG_FILE_NAMES])])dnl
AC_DEFUN(AC_RESTARTABLE_SYSCALLS, [indir([AC_SYS_RESTARTABLE_SYSCALLS])])dnl
AC_DEFUN(AC_FIND_X, [indir([AC_PATH_X])])dnl
-AC_DEFUN(AC_FIND_X_XMKMF, [indir([AC_PATH_X_XMKMF])])dnl
-AC_DEFUN(AC_FIND_X_DIRECT, [indir([AC_PATH_X_DIRECT])])dnl
AC_DEFUN(AC_FIND_XTRA, [indir([AC_PATH_XTRA])])dnl
AC_DEFUN(AC_AIX, [indir([AC_OS_AIX])])dnl
AC_DEFUN(AC_MINIX, [indir([AC_OS_MINIX])])dnl
AC_DEFUN(AC_ISC_POSIX, [indir([AC_OS_ISC])])dnl
-AC_DEFUN(AC_XENIX_DIR, [indir([AC_OS_XENIX])])dnl
-AC_DEFUN(AC_SCO_INTL, [indir([AC_OS_SCO])])dnl
-AC_DEFUN(AC_IRIX_SUN, [indir([AC_OS_IRIX])])dnl
-AC_DEFUN(AC_DYNIX_SEQ, [indir([AC_OS_DYNIX])])dnl
fi
])
+define(AC_PROG_CC_ANSI,
+[AC_MSG_CHECKING(for ${CC-cc} option to accept ANSI C)
+AC_CACHE_VAL(ac_cv_prog_cc_ansi,
+[ac_cv_prog_cc_ansi=no
+ac_save_CFLAGS="$CFLAGS"
+# Don't try gcc -ansi; that turns off useful extensions and
+# breaks some systems' header files.
+# AIX -qlanglvl=ansi
+# Ultrix and OSF/1 -std1
+# HP-UX -Aa
+# SVR4 -Xc
+for ac_arg in "" -qlanglvl=ansi -std1 -Aa -Xc
+do
+ CFLAGS="$ac_save_CFLAGS $ac_arg"
+dnl Don't use CPP directly in case it doesn't take these options.
+ AC_TRY_LINK(,
+[#if !defined(__STDC__) || __STDC__ != 1
+notansi(); /* Produce a link error if not ANSI C. */
+#endif
+], [ac_cv_prog_cc_ansi=$ac_arg; break])
+done
+CFLAGS="$ac_save_CFLAGS"
+])
+AC_MSG_RESULT($ac_cv_prog_cc_ansi)
+test "$ac_cv_prog_cc_ansi" != no && CC="$CC $ac_cv_prog_cc_ansi"
+])
+
AC_DEFUN(AC_PROG_CC_C_O,
[if test "x$CC" != xcc; then
AC_MSG_CHECKING(whether $CC and cc understand -c and -o together)
[AC_OBSOLETE([$0],
[; instead use AC_CHECK_HEADERS(string.h) and HAVE_STRING_H])dnl
AC_MSG_CHECKING([for BSD string and memory functions])
-AC_TRY_LINK([#include <strings.h>], [rindex(0, 0); bzero(0, 0);], ,
+AC_TRY_LINK([#include <strings.h>], [rindex(0, 0); bzero(0, 0);],
[AC_MSG_RESULT(yes); AC_DEFINE(USG)], [AC_MSG_RESULT(no)])])
[ac_header_dirent=no
AC_CHECK_HEADERS_DIRENT(dirent.h sys/ndir.h sys/dir.h ndir.h,
[ac_header_dirent=$ac_hdr; break])
+# Two versions of opendir et al. are in -ldir and -lx on SCO Xenix,
+# and -lx contains other useful things as well. (FIXME what are they?)
+if test $ac_header_dirent = dirent.h; then
+AC_CHECK_LIB(dir, opendir, LIBS="$LIBS -ldir")
+fi
+AC_CHECK_LIB(x, main, LIBS="$LIBS -lx")
])
dnl Like AC_CHECK_HEADER, except also make sure that HEADER-FILE
AC_DEFINE_UNQUOTED(${ac_tr_hdr}) $2])dnl
done])
-AC_DEFUN(AC_FUNC_CLOSEDIR_VOID,
-[AC_REQUIRE([AC_HEADER_DIRENT])dnl
-AC_MSG_CHECKING(whether closedir returns void)
-AC_CACHE_VAL(ac_cv_func_closedir_void,
-[AC_TRY_RUN([#include <sys/types.h>
-#include <$ac_header_dirent>
-int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
- ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
-AC_MSG_RESULT($ac_cv_func_closedir_void)
-if test $ac_cv_func_closedir_void = yes; then
- AC_DEFINE(CLOSEDIR_VOID)
-fi
-])
-
dnl Obsolete.
AC_DEFUN(AC_DIR_HEADER,
[ac_header_dirent=no
dnl ### Checks for functions
+AC_DEFUN(AC_FUNC_CLOSEDIR_VOID,
+[AC_REQUIRE([AC_HEADER_DIRENT])dnl
+AC_MSG_CHECKING(whether closedir returns void)
+AC_CACHE_VAL(ac_cv_func_closedir_void,
+[AC_TRY_RUN([#include <sys/types.h>
+#include <$ac_header_dirent>
+int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
+ ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
+AC_MSG_RESULT($ac_cv_func_closedir_void)
+if test $ac_cv_func_closedir_void = yes; then
+ AC_DEFINE(CLOSEDIR_VOID)
+fi
+])
+
AC_DEFUN(AC_FUNC_MMAP,
[AC_MSG_CHECKING(for working mmap)
AC_CACHE_VAL(ac_cv_func_mmap,
fi
])
+AC_DEFUN(AC_FUNC_GETMNTENT,
+[# getmntent is in -lsun on Irix 4, -lseq on PTX.
+AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
+AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
+AC_CHECK_FUNC(getmntent, [AC_DEFINE(HAVE_GETMNTENT)])])
+
+AC_DEFUN(AC_FUNC_STRFTIME,
+[# strftime is in -lintl on SCO UNIX.
+AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
+AC_CHECK_FUNC(strftime, [AC_DEFINE(HAVE_STRFTIME)])])
+
dnl ### Checks for structure members
])
AC_DEFUN(AC_INT_16_BITS,
-[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(int)])
+[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(int)])dnl
AC_MSG_CHECKING(whether int is 16 bits)
AC_TRY_RUN([main() { exit(sizeof(int) != 2); }],
[AC_MSG_RESULT(yes)
])
AC_DEFUN(AC_LONG_64_BITS,
-[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(long)])
+[AC_OBSOLETE([$0], [; instead use AC_CHECK_SIZEOF(long)])dnl
AC_MSG_CHECKING(whether long int is 64 bits)
AC_TRY_RUN([main() { exit(sizeof(long int) != 8); }],
[AC_MSG_RESULT(yes)
# msh@cis.ufl.edu says -lnsl (and -lsocket) are needed for his 386/AT,
# to get the SysV transport functions.
- # Not sure which flavor of 386 Unix this is, but it seems harmless to
+ # Not sure which flavor of 386 UNIX this is, but it seems harmless to
# check for it.
AC_CHECK_LIB(nsl, t_accept, [X_EXTRA_LIBS="$X_EXTRA_LIBS -lnsl"])
[AC_BEFORE([$0], [AC_TRY_LINK])dnl
AC_BEFORE([$0], [AC_TRY_RUN])dnl
AC_CHECK_HEADER(minix/config.h, MINIX=yes, MINIX=)
-# The Minix shell can not assign to the same variable on the same line!
if test "$MINIX" = yes; then
AC_DEFINE(_POSIX_SOURCE)
AC_DEFINE(_POSIX_1_SOURCE, 2)
fi
])
-AC_DEFUN(AC_OS_XENIX,
-[AC_REQUIRE([AC_DIR_HEADER])dnl
+AC_DEFUN(AC_XENIX_DIR,
+[AC_OBSOLETE([$0], [; instead use AC_HEADER_DIRENT])dnl
+AC_REQUIRE([AC_DIR_HEADER])dnl
AC_MSG_CHECKING(for Xenix)
AC_EGREP_CPP(yes,
[#if defined(M_XENIX) && !defined(M_UNIX)
#endif
], [AC_MSG_RESULT(yes); XENIX=yes], [AC_MSG_RESULT(no); XENIX=])
if test "$XENIX" = yes; then
+ # Make sure -ldir precedes -lx.
+ test $ac_header_dirent = dirent.h && LIBS="$LIBS -ldir"
LIBS="$LIBS -lx"
- if test $ac_header_dirent != sys/ndir.h; then
- LIBS="-ldir $LIBS" # Make sure -ldir precedes -lx.
- fi
fi
])
-AC_DEFUN(AC_OS_SCO,
-[AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
+AC_DEFUN(AC_DYNIX_SEQ,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_GETMNTENT])dnl
+AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
])
-AC_DEFUN(AC_OS_IRIX,
-[AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
+AC_DEFUN(AC_IRIX_SUN,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_GETMNTENT])dnl
+AC_CHECK_LIB(sun, getmntent, LIBS="$LIBS -lsun")
])
-AC_DEFUN(AC_OS_DYNIX,
-[AC_CHECK_LIB(seq, getmntent, LIBS="$LIBS -lseq")
+AC_DEFUN(AC_SCO_INTL,
+[AC_OBSOLETE([$0], [; instead use AC_FUNC_STRFTIME])dnl
+AC_CHECK_LIB(intl, strftime, LIBS="$LIBS -lintl")
])
projects / thirdparty / autoconf.git / commitdiff
