# Files that can be generated, but should be up to date for a distribution.
DISTDEP = info Makefile
# Files to distribute.
-DISTFILES = COPYING ChangeLog INSTALL Makefile.in NEWS README \
+DISTFILES = COPYING ChangeLog INSTALL Makefile.in NEWS README TODO \
acconfig.h acfunctions acgeneral.m4 acheaders acidentifiers \
acmakevars acoldnames.m4 acprograms acspecific.m4 autoconf.info* \
autoconf.sh autoconf.texi install.texi \
config.status: configure
./config.status --recheck
-# FIXME this doesn't work.
clean mostlyclean distclean realclean::
for dir in $(SUBDIRS); do \
echo making $@ in $$dir ; \
(cd $$dir; $(MAKE) $@) ; \
done
-clean::
+clean mostlyclean distclean realclean::
rm -f autoconf autoheader autoscan autoreconf autoupdate
rm -f shindent ifnames *.tmp
rm -f *.aux *.cp *.cps *.dvi *.fn *.fns *.ky *.kys *.log
rm -f *.pg *.pgs *.toc *.tp *.tps *.vr *.vrs *.ma *.mas
-mostlyclean:: clean
-
-distclean:: clean
+distclean realclean::
rm -f Makefile config.status config.cache config.log
-realclean:: distclean
+realclean::
rm -f TAGS *.info* INSTALL
TAGS:
/* Define if type char is unsigned and you are not using gcc. */
#undef __CHAR_UNSIGNED__
+/* Define if the closedir function returns void instead of int. */
+#undef CLOSEDIR_VOID
+
/* Define to empty if the keyword does not work. */
#undef const
/* Define for DGUX with <sys/dg_sys_info.h>. */
#undef DGUX
-/* Define if you have dirent.h. */
+/* Define if you have <dirent.h>. */
#undef DIRENT
/* Define to the type of elements in the array set by `getgroups'.
/* Define to `int' if <sys/types.h> doesn't define. */
#undef gid_t
-/* Define if you have alloca.h and it should be used (not Ultrix). */
+/* Define if you have <alloca.h> and it should be used (not on Ultrix). */
#undef HAVE_ALLOCA_H
+/* Define if you have <dirent.h>. */
+#undef HAVE_DIRENT_H
+
/* Define if you don't have vprintf but do have _doprnt. */
#undef HAVE_DOPRNT
/* Define if you have a working `mmap' system call. */
#undef HAVE_MMAP
-/* Define if you have netdb.h (and thus the rexec function). */
+/* Define if you don't have <dirent.h>, but have <ndir.h>. */
+#undef HAVE_NDIR_H
+
+/* Define if you have <netdb.h> (and thus the rexec function). */
#undef HAVE_NETDB_H
/* Define if system calls automatically restart after interruption
/* Define if your struct stat has st_rdev. */
#undef HAVE_ST_RDEV
-/* Define if you have sys/mtio.h. */
+/* Define if you don't have <dirent.h>, but have <sys/dir.h>. */
+#undef HAVE_SYS_DIR_H
+
+/* Define if you have <sys/mtio.h>. */
#undef HAVE_SYS_MTIO_H
+/* Define if you don't have <dirent.h>, but have <sys/ndir.h>. */
+#undef HAVE_SYS_NDIR_H
+
/* Define if you have a <sys/wait.h> with `union wait'. */
#undef HAVE_SYS_WAIT
/* Define if `union wait' is the type of the first arg to wait functions. */
#undef HAVE_UNION_WAIT
-/* Define if you have unistd.h. */
+/* Define if you have <unistd.h>. */
#undef HAVE_UNISTD_H
/* Define if utime(file, NULL) sets file's timestamp to the present. */
#undef HAVE_UTIME_NULL
-/* Define if you have vfork.h. */
+/* Define if you have <vfork.h>. */
#undef HAVE_VFORK_H
/* Define if you have the vprintf function. */
/* Define if long int is 64 bits. */
#undef LONG_64_BITS
-/* Define if major, minor, and makedev are declared in mkdev.h. */
+/* Define if major, minor, and makedev are declared in <mkdev.h>. */
#undef MAJOR_IN_MKDEV
-/* Define if major, minor, and makedev are declared in sysmacros.h. */
+/* Define if major, minor, and makedev are declared in <sysmacros.h>. */
#undef MAJOR_IN_SYSMACROS
/* Define if on MINIX. */
/* Define to `int' if <sys/types.h> doesn't define. */
#undef mode_t
-/* Define if you don't have dirent.h, but have ndir.h. */
+/* Define if you don't have <dirent.h>, but have <ndir.h>. */
#undef NDIR
-/* Define if you have memory.h, and string.h doesn't declare the
+/* Define if you have <memory.h>, and <string.h> doesn't declare the
mem* functions. */
#undef NEED_MEMORY_H
/* Define if your struct nlist has an n_un member. */
#undef NLIST_NAME_UNION
-/* Define if you have nlist.h. */
+/* Define if you have <nlist.h>. */
#undef NLIST_STRUCT
/* Define if you can't use the address of an argument to a function
/* Define on System V Release 4. */
#undef SVR4
-/* Define if you don't have dirent.h, but have sys/dir.h. */
+/* Define if you don't have <dirent.h>, but have <sys/dir.h>. */
#undef SYSDIR
-/* Define if you don't have dirent.h, but have sys/ndir.h. */
+/* Define if you don't have <dirent.h>, but have <sys/ndir.h>. */
#undef SYSNDIR
/* Define if `sys_siglist' is declared by <signal.h>. */
instead of <sys/cpustats.h>. */
#undef UMAX4_3
-/* Define if you do not have strings.h, index, bzero, etc.. */
+/* Define if you do not have <strings.h>, index, bzero, etc.. */
#undef USG
/* Define vfork as fork if vfork does not work. */
ifdef([__gnu__], , [errprint(Autoconf requires GNU m4
)m4exit(2)])dnl
dnl
-define(AC_ACVERSION, 1.96)dnl
+define(AC_ACVERSION, 1.97)dnl
dnl This is defined by the --version option of the autoconf script.
ifdef([AC_PRINT_VERSION], [Autoconf version AC_ACVERSION
m4exit(0)])dnl
changequote(, )dnl
ac_usage="Usage: configure [options] [host]
Options: [defaults in brackets after descriptions]
---build=BUILD configure for building on BUILD [BUILD=HOST]
+Configuration:
--cache-file=FILE cache test results in FILE
---disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
---enable-FEATURE[=ARG] include FEATURE [ARG=yes]
---exec-prefix=PREFIX install host dependent files in PREFIX [/usr/local]
--help print this message
---host=HOST configure for HOST [guessed]
--no-create do not create output files
---prefix=PREFIX install host independent files in PREFIX [/usr/local]
--quiet, --silent do not print \`checking for...' messages
---srcdir=DIR find the sources in DIR [configure dir or ..]
---target=TARGET configure for TARGET [TARGET=HOST]
--verbose print results of checks
--version print the version of autoconf that created configure
+Directories:
+--exec-prefix=PREFIX install host dependent files in PREFIX [/usr/local]
+--prefix=PREFIX install host independent files in PREFIX [/usr/local]
+--srcdir=DIR find the sources in DIR [configure dir or ..]
+Host type:
+--build=BUILD configure for building on BUILD [BUILD=HOST]
+--host=HOST configure for HOST [guessed]
+--target=TARGET configure for TARGET [TARGET=HOST]
+Features and packages:
+--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
+--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--x-includes=DIR X include files are in DIR
for ac_site_dir in $ac_site_dirs; do
ac_site_file=$ac_site_dir/lib/config.site
if test -r "$ac_site_file"; then
- AC_MSG_RESULT(loading site initialization script $ac_site_file)
+ echo "loading site initialization script $ac_site_file"
. $ac_site_file
fi
done
dnl
define(AC_CACHE_LOAD,
[if test -r "$cache_file"; then
- AC_MSG_RESULT(loading test results from cache file $cache_file)
+ echo "loading test results from cache file $cache_file"
. $cache_file
else
- AC_MSG_RESULT(creating new cache file $cache_file)
+ echo "creating new cache file $cache_file"
> $cache_file
fi])dnl
dnl
define(AC_CACHE_SAVE,
[if test -w $cache_file; then
-AC_MSG_RESULT(saving test results in cache file $cache_file)
+echo "saving test results in cache file $cache_file"
cat > $cache_file <<\CEOF
# This file is a shell script that caches the results of configure
# tests run on this system so they can be shared between configure
cat >> ${CONFIG_STATUS} <<\EOF
ac_given_srcdir=$srcdir
+ac_given_INSTALL=$INSTALL
CONFIG_FILES=${CONFIG_FILES-"$1"}
for ac_file in .. ${CONFIG_FILES}; do if test "x$ac_file" != x..; then
# The file is in a subdirectory.
test ! -d "$ac_dir" && mkdir "$ac_dir"
ac_dir_suffix="/$ac_dir"
+ # A "../" for each directory in $ac_dir_suffix.
+changequote(, )dnl
+ ac_dots=`echo $ac_dir_suffix|sed 's%/[^/]*%../%g'`
+changequote([, ])dnl
else
- ac_dir_suffix=
+ ac_dir_suffix= ac_dots=
fi
-changequote(, )dnl
- # A "../" for each directory in $ac_dir_suffix.
- ac_dots=`echo $ac_dir_suffix|sed 's%/[^/]*%../%g'`
-changequote([, ])dnl
case "$ac_given_srcdir" in
.) srcdir=.
- if test -z "$ac_dir_suffix"; then top_srcdir=.
+ if test -z "$ac_dots"; then top_srcdir=.
else top_srcdir=`echo $ac_dots|sed 's%/$%%'`; fi ;;
/*) srcdir="$ac_given_srcdir$ac_dir_suffix"; top_srcdir="$ac_given_srcdir" ;;
*) # Relative path.
top_srcdir="$ac_dots$ac_given_srcdir" ;;
esac
+ case "$ac_given_INSTALL" in
+changequote(, )dnl
+ [/$]*) INSTALL="$ac_given_INSTALL" ;;
+changequote([, ])dnl
+ *) INSTALL="$ac_dots$ac_given_INSTALL" ;;
+ esac
+
echo creating "$ac_file"
rm -f "$ac_file"
comment_str="Generated automatically from `echo $ac_file|sed 's|.*/||'`.in by configure."
RTAPELIB=rtapelib.o
else
AC_MSG_RESULT(found no remote shell)
- AC_CHECK_HEADER(netdb.h, RTAPELIB=rtapelib.o AC_DEFINE(HAVE_NETDB_H),
- RTAPELIB= AC_DEFINE(NO_REMOTE))
+ AC_CHECK_HEADER(netdb.h, [RTAPELIB=rtapelib.o AC_DEFINE(HAVE_NETDB_H)],
+ [RTAPELIB= AC_DEFINE(NO_REMOTE)])
fi
AC_SUBST(RSH)dnl
AC_SUBST(RTAPELIB)dnl
done])dnl
case "$ac_cv_header_dir" in
-dirent.h) AC_DEFINE(DIRENT)
-AC_DEFINE(HAVE_DIRENT_H) ;;
-sys/ndir.h) AC_DEFINE(SYSNDIR)
-AC_DEFINE(HAVE_SYS_NDIR_H) ;;
-sys/dir.h) AC_DEFINE(SYSDIR)
-AC_DEFINE(HAVE_SYS_DIR_H) ;;
-ndir.h) AC_DEFINE(NDIR)
-AC_DEFINE(HAVE_NDIR_H) ;;
+dirent.h) AC_DEFINE(HAVE_DIRENT_H) ;;
+sys/ndir.h) AC_DEFINE(HAVE_SYS_NDIR_H) ;;
+sys/dir.h) AC_DEFINE(HAVE_SYS_DIR_H) ;;
+ndir.h) AC_DEFINE(HAVE_NDIR_H) ;;
+esac
+
+AC_MSG_CHECKING(for closedir return value)
+AC_CACHE_VAL(ac_cv_func_closedir_void,
+[AC_TRY_RUN([#include <sys/types.h>
+#include <$ac_cv_header_dir>
+int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
+ ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
+if test $ac_cv_func_closedir_void = yes; then
+ AC_DEFINE(CLOSEDIR_VOID)
+fi
+])dnl
+dnl
+dnl Obsolete.
+define(AC_DIR_HEADER,
+[AC_PROVIDE([$0])dnl
+AC_MSG_CHECKING(for directory library header)
+AC_CACHE_VAL(ac_cv_header_dir,
+[ac_cv_header_dir=no
+for ac_hdr in dirent.h sys/ndir.h sys/dir.h ndir.h; do
+ AC_MSG_CHECKING([for $ac_hdr])
+AC_TRY_LINK([#include <sys/types.h>
+#include <$ac_hdr>], [DIR *dirp = 0;], ac_cv_header_dir=$ac_hdr; break)
+done])dnl
+
+case "$ac_cv_header_dir" in
+dirent.h) AC_DEFINE(DIRENT) ;;
+sys/ndir.h) AC_DEFINE(SYSNDIR) ;;
+sys/dir.h) AC_DEFINE(SYSDIR) ;;
+ndir.h) AC_DEFINE(NDIR) ;;
esac
AC_MSG_CHECKING(for closedir return value)
@c @setchapternewpage odd
@c %**end of header
-@set EDITION 1.96
-@set VERSION 1.96
+@set EDITION 1.97
+@set VERSION 1.97
@set UPDATED August 1994
@iftex
Writing Macros
* Macro Format:: Basic format of an Autoconf macro.
+* Macro Naming:: What to call your new macros.
* Quoting:: Protecting macros from unwanted expansion.
* Dependencies Between Macros:: What to do when macros depend on other macros.
* Checking for Files:: Finding whether a file exists.
* Guidelines:: General rules for writing test programs.
* Tricks:: Special ways to work around problems.
+Caching Values
+
+* Cache Files:: Files @code{configure} uses for caching.
+* Cache Variables:: Shell variables used in caches.
+
Makefiles
* Predefined Variables:: Heavily used @code{make} variables.
The @code{autoupdate} program updates a @file{configure.in} file that
calls Autoconf macros by their old names to use the current macro names.
In version 2 of Autoconf, most of the macros were renamed to use a more
-uniform and descriptive naming scheme. Although the old names still
-work (@pxref{Old Macro Names}, for a list of the old macro names and the
+uniform and descriptive naming scheme. @xref{Macro Naming}, for a
+description of the new scheme. Although the old names still work
+(@pxref{Old Macro Names}, for a list of the old macro names and the
corresponding new names), you can make your @file{configure.in} files
more readable and make it easier to use the current Autoconf
documentation if you update them to use the new macro names.
programs:
@defmac AC_PROG_GCC_TRADITIONAL
-@maindex GCC_TRADITIONAL
+@maindex PROG_GCC_TRADITIONAL
Add @samp{-traditional} to @code{make} variable @code{CC} if using the
GNU C compiler and @code{ioctl} does not work properly without
@samp{-traditional}. This macro calls @code{AC_PROG_CC} and
@end defmac
@defmac AC_PROG_LN_S
-@maindex LN_S
+@maindex PROG_LN_S
If @samp{ln -s} works on the current filesystem (the operating system
and filesystem support symbolic links), set shell and @code{make}
variable @code{LN_S} to @samp{ln -s}, otherwise set it to @samp{ln}.
@end defmac
@defmac AC_PROG_CC_C_O
-@maindex MINUS_C_MINUS_O
+@maindex PROG_CC_C_O
@vindex NO_MINUS_C_MINUS_O
If the C compiler does not accept the @samp{-c} and @samp{-o} options
simultaneously, define @code{NO_MINUS_C_MINUS_O}.
@end defmac
@defmac AC_PROG_RSH
-@maindex RSH
+@maindex PROG_RSH
@vindex RSH
@vindex NO_REMOTE
@vindex HAVE_NETDB_H
@end defmac
@defmac AC_PROG_MAKE_SET
-@maindex SET_MAKE
+@maindex PROG_MAKE_SET
If @code{make} predefines the variable @code{MAKE}, define @code{make}
variable @code{SET_MAKE} to be empty. Otherwise, define @code{SET_MAKE}
to contain @samp{MAKE=make}. Calls @code{AC_SUBST} for @code{SET_MAKE}.
@end defmac
@defmac AC_DECL_YYTEXT
-@maindex YYTEXT_POINTER
+@maindex DECL_YYTEXT
@vindex YYTEXT_POINTER
Define @code{YYTEXT_POINTER} if @code{yytext} is a @samp{char *} instead
of a @samp{char []}. This depends on whether @code{lex} or @code{flex}
The following macros check for the presence of certain C header files:
-@defmac AC_HEADER_DIRENT
+@defmac AC_DIR_HEADER
@maindex DIR_HEADER
@vindex DIRENT
-@vindex HAVE_DIRENT_H
-@vindex HAVE_NDIR_H
-@vindex HAVE_SYS_DIR_H
-@vindex HAVE_SYS_NDIR_H
@vindex SYSDIR
@vindex SYSNDIR
@vindex NDIR
@vindex VOID_CLOSEDIR
-Check for the the following header files, and for the first one that is
-found, define the listed macros (the second macros listed are for
-backward compatibility, and are considered obsolete):
+Like @code{AC_HEADER_DIRENT}, but defines a different set of C
+preprocessor macros to indicate which header file is found. This macro
+and the names it defines are considered obsolete. The names it defines are:
@table @file
@item dirent.h
-Define @code{HAVE_DIRENT_H} and @code{DIRENT}.
+@code{DIRENT}
@item sys/ndir.h
-Define @code{HAVE_SYS_NDIR_H} and @code{SYSNDIR}.
+@code{SYSNDIR}
@item sys/dir.h
-Define @code{HAVE_SYS_DIR_H} and @code{SYSDIR}.
+@code{SYSDIR}
@item ndir.h
-Define @code{HAVE_NDIR_H} and @code{NDIR}.
+@code{NDIR}
@end table
Also, if the directory library header file contains a declaration of the
@code{closedir} function with a @code{void} return type, define
@code{VOID_CLOSEDIR}.
+@end defmac
+
+@defmac AC_HEADER_DIRENT
+@maindex HEADER_DIRENT
+@vindex HAVE_DIRENT_H
+@vindex HAVE_NDIR_H
+@vindex HAVE_SYS_DIR_H
+@vindex HAVE_SYS_NDIR_H
+@vindex CLOSEDIR_VOID
+Check for the the following header files, and for the first one that is
+found, define the listed C preprocessor macro:
+
+@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
+
+Also, if the directory library header file contains a declaration of the
+@code{closedir} function with a @code{void} return type, define
+@code{CLOSEDIR_VOID}.
The directory library declarations in the source code should look
something like the following, which assumes that you have also called
@end defmac
@defmac AC_HEADER_MAJOR
-@maindex MAJOR_HEADER
+@maindex HEADER_MAJOR
@vindex MAJOR_IN_MKDEV
@vindex MAJOR_IN_SYSMACROS
If @file{sys/types.h} does not define @code{major}, @code{minor}, and
@end defmac
@defmac AC_HEADER_STDC
-@maindex STDC_HEADERS
+@maindex HEADER_STDC
@vindex STDC_HEADERS
Define @code{STDC_HEADERS} if the system has ANSI C header files.
Specifically, this macro checks for @file{stdlib.h}, @file{stdarg.h},
@end defmac
@defmac AC_DECL_SYS_SIGLIST
-@maindex SYS_SIGLIST_DECLARED
+@maindex DECL_SYS_SIGLIST
@vindex SYS_SIGLIST_DECLARED
Define @code{SYS_SIGLIST_DECLARED} if the variable @code{sys_siglist} is
declared in a system header file, either @file{signal.h} or
The following macros check for predefined C types:
@defmac AC_TYPE_GETGROUPS
-@maindex GETGROUPS_T
+@maindex TYPE_GETGROUPS
@vindex GETGROUPS_T
Define @code{GETGROUPS_T} to be whichever of @code{gid_t} or @code{int}
is the base type of the array argument to @code{getgroups}.
@end defmac
@defmac AC_TYPE_MODE_T
-@maindex MODE_T
+@maindex TYPE_MODE_T
@vindex mode_t
If @code{mode_t} is not defined in @file{sys/types.h}, define
@code{mode_t} to be @code{int}.
@end defmac
@defmac AC_TYPE_OFF_T
-@maindex OFF_T
+@maindex TYPE_OFF_T
@vindex off_t
If @code{off_t} is not defined in @file{sys/types.h}, define
@code{off_t} to be @code{long}.
@end defmac
@defmac AC_TYPE_PID_T
-@maindex PID_T
+@maindex TYPE_PID_T
@vindex pid_t
If @code{pid_t} is not defined in @file{sys/types.h}, define
@code{pid_t} to be @code{int}.
@end defmac
@defmac AC_TYPE_SIGNAL
-@maindex RETSIGTYPE
+@maindex TYPE_SIGNAL
@vindex RETSIGTYPE
If @file{signal.h} declares @code{signal} as returning a pointer to a
function returning @code{void}, define @code{RETSIGTYPE} to be
@end defmac
@defmac AC_TYPE_SIZE_T
-@maindex SIZE_T
+@maindex TYPE_SIZE_T
@vindex size_t
If @code{size_t} is not defined in @file{sys/types.h}, define
@code{size_t} to be @code{unsigned}.
@end defmac
@defmac AC_TYPE_UID_T
-@maindex UID_T
+@maindex TYPE_UID_T
@vindex uid_t
@vindex gid_t
If @code{uid_t} is not defined in @file{sys/types.h}, define
The following macros check for particular C library functions:
@defmac AC_FUNC_ALLOCA
-@maindex ALLOCA
+@maindex FUNC_ALLOCA
@vindex C_ALLOCA
@vindex HAVE_ALLOCA_H
Check how to get @code{alloca}. Tries to get a builtin version by
@end defmac
@defmac AC_FUNC_GETLOADAVG
-@maindex GETLOADAVG
+@maindex FUNC_GETLOADAVG
@vindex SVR4
@vindex DGUX
@vindex UMAX
@end defmac
@defmac AC_FUNC_MMAP
-@maindex MMAP
+@maindex FUNC_MMAP
@vindex HAVE_MMAP
If the @code{mmap} function exists and works correctly, define
@code{HAVE_MMAP}.
@end defmac
@defmac AC_FUNC_SETVBUF_REVERSED
-@maindex SETVBUF_REVERSED
+@maindex FUNC_SETVBUF_REVERSED
@vindex SETVBUF_REVERSED
If @code{setvbuf} takes the buffering type as its second argument and
the buffer pointer as the third, instead of the other way around, define
@end defmac
@defmac AC_FUNC_STRCOLL
-@maindex STRCOLL
+@maindex FUNC_STRCOLL
@vindex HAVE_STRCOLL
If the @code{strcoll} function exists and works correctly, define
@code{HAVE_STRCOLL}. This does a bit more than
@end defmac
@defmac AC_FUNC_UTIME_NULL
-@maindex UTIME_NULL
+@maindex FUNC_UTIME_NULL
@vindex HAVE_UTIME_NULL
If @samp{utime(@var{file}, NULL)} sets @var{file}'s timestamp to
the present, define @code{HAVE_UTIME_NULL}.
@end defmac
@defmac AC_FUNC_VFORK
-@maindex VFORK
+@maindex FUNC_VFORK
@vindex HAVE_VFORK_H
@vindex vfork
If @file{vfork.h} is found, define @code{HAVE_VFORK_H}. If a working
@end defmac
@defmac AC_FUNC_VPRINTF
-@maindex VPRINTF
+@maindex FUNC_VPRINTF
@vindex HAVE_VPRINTF
@vindex HAVE_DOPRNT
If @code{vprintf} is found, define @code{HAVE_VPRINTF}. Otherwise, if
@end defmac
@defmac AC_FUNC_WAIT3
-@maindex WAIT3
+@maindex FUNC_WAIT3
@vindex HAVE_WAIT3
If @code{wait3} is found and fills in the contents of its third argument
(a @samp{struct rusage *}), which HP-UX does not do, define
The following macros check for certain structures or structure members:
@defmac AC_HEADER_STAT
-@maindex STAT_MACROS_BROKEN
+@maindex HEADER_STAT
@maindex STAT_MACROS_BROKEN
If the macros @code{S_ISDIR}, @code{S_ISREG} et al. defined in
@file{sys/stat.h} do not work properly (returning false positives),
@end defmac
@defmac AC_STRUCT_ST_BLKSIZE
-@maindex ST_BLKSIZE
+@maindex STRUCT_ST_BLKSIZE
@vindex HAVE_ST_BLKSIZE
If @code{struct stat} contains an @code{st_blksize} member, define
@code{HAVE_ST_BLKSIZE}.
@end defmac
@defmac AC_STRUCT_ST_BLOCKS
-@maindex ST_BLOCKS
+@maindex STRUCT_ST_BLOCKS
@vindex HAVE_ST_BLOCKS
If @code{struct stat} contains an @code{st_blocks} member, define
@code{HAVE_ST_BLOCKS}. Otherwise, add @samp{fileblocks.o} to the
@end defmac
@defmac AC_STRUCT_ST_RDEV
-@maindex ST_RDEV
+@maindex STRUCT_ST_RDEV
@vindex HAVE_ST_RDEV
If @code{struct stat} contains an @code{st_rdev} member, define
@code{HAVE_ST_RDEV}.
@end defmac
@defmac AC_HEADER_TIME
-@maindex TIME_WITH_SYS_TIME
+@maindex HEADER_TIME
@vindex TIME_WITH_SYS_TIME
If a program may include both @file{time.h} and @file{sys/time.h},
define @code{TIME_WITH_SYS_TIME}. On some older systems,
@end defmac
@defmac AC_STRUCT_TIMEZONE
-@maindex TIMEZONE
+@maindex STRUCT_TIMEZONE
@vindex HAVE_TM_ZONE
@vindex HAVE_TZNAME
Figure out how to get the current timezone. If @code{struct tm} has a
features:
@defmac AC_C_ARG_ARRAY
-@maindex ARG_ARRAY
+@maindex C_ARG_ARRAY
@vindex NO_ARG_ARRAY
If the address of an argument to a C function can not be used like
the start of an array, define @code{NO_ARG_ARRAY}. This ability allows
@end defmac
@defmac AC_TRY_CROSS
-@maindex CROSS_CHECK
+@maindex TRY_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
@defmac AC_C_CHAR_UNSIGNED
-@maindex CHAR_UNSIGNED
+@maindex C_CHAR_UNSIGNED
@vindex __CHAR_UNSIGNED__
If the C type @code{char} is unsigned, define @code{__CHAR_UNSIGNED__},
unless the C compiler predefines it.
@end defmac
@defmac AC_C_CONST
-@maindex CONST
+@maindex C_CONST
@vindex const
If the C compiler does not fully support the keyword @code{const},
define @code{const} to be empty. Some C compilers that do not define
@end defmac
@defmac AC_C_INLINE
-@maindex INLINE
+@maindex C_INLINE
@vindex inline
If the C compiler is a version of GCC that supports the keyword
@code{__inline} but not @code{inline} (such as some NeXT versions),
@end defmac
@defmac AC_C_LONG_DOUBLE
-@maindex HAVE_LONG_DOUBLE
+@maindex C_LONG_DOUBLE
@vindex HAVE_LONG_DOUBLE
If the C compiler supports the @code{long double} type, define
@code{HAVE_LONG_DOUBLE}. Some C compilers that do not define
@end defmac
@defmac AC_C_BIGENDIAN
-@maindex WORDS_BIGENDIAN
+@maindex C_BIGENDIAN
@vindex WORDS_BIGENDIAN
If words are stored with the most significant byte first (like Motorola
and SPARC, but not Intel and VAX, CPUs), define @code{WORDS_BIGENDIAN}.
The following macros check for operating system services:
@defmac AC_PATH_X
-@maindex FIND_X
+@maindex PATH_X
Try to locate the X Window System include files and libraries. Try
first by running @code{xmkmf} on a trivial @file{Imakefile} and
examining the @file{Makefile} that it produces. If that fails (such as
@end defmac
@defmac AC_PATH_XTRA
-@maindex FIND_XTRA
+@maindex PATH_XTRA
An enhanced version of @code{AC_PATH_X}. Put the C compiler flags that
X needs into @code{make} variable @code{X_CFLAGS}, and the X linker
flags into @code{X_LIBS}. If X is not available, put
you should let it call @code{AC_PATH_X} rather than doing that yourself.
@end defmac
-@defmac AC_HAVE_POUNDBANG (@var{action-if-supported} @r{[}, @var{action-if-not-supported}@r{]})
+@defmac AC_HAVE_POUNDBANG (@var{action-if-supported} @r{[},
+@var{action-if-not-supported}@r{]})
@maindex HAVE_POUNDBANG
Check whether the system supports starting shell scripts with a line of
the form @samp{#!/bin/csh} to select the shell to use. If @samp{#!}
@end defmac
@defmac AC_SYS_LONG_FILE_NAMES
-@maindex LONG_FILE_NAMES
+@maindex SYS_LONG_FILE_NAMES
@vindex HAVE_LONG_FILE_NAMES
If the system supports file names longer than 14 characters, define
@code{HAVE_LONG_FILE_NAMES}.
@end defmac
@defmac AC_SYS_REMOTE_TAPE
-@maindex REMOTE_TAPE
+@maindex SYS_REMOTE_TAPE
@vindex HAVE_SYS_MTIO_H
If BSD tape drive ioctls are available, define @code{HAVE_SYS_MTIO_H},
and if sockets are available add @code{rmt} to @code{make} variable
@end defmac
@defmac AC_SYS_RESTARTABLE_SYSCALLS
-@maindex RESTARTABLE_SYSCALLS
+@maindex SYS_RESTARTABLE_SYSCALLS
@vindex HAVE_RESTARTABLE_SYSCALLS
If the system automatically restarts a system call that is interrupted
by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}.
functions they make available or the environments they provide.
@defmac AC_OS_AIX
-@maindex AIX
+@maindex OS_AIX
@vindex _ALL_SOURCE
If on AIX, define @code{_ALL_SOURCE}. Allows the use of some BSD
functions. Should be called before any macros that run the C compiler.
@end defmac
@defmac AC_OS_DYNIX
-@maindex DYNIX_SEQ
+@maindex OS_DYNIX
If on DYNIX/ptx (Sequent UNIX), add @samp{-lseq} to @code{make}
variable @code{LIBS}. Allows use of some BSD system calls and
@code{getmntent}.
@end defmac
@defmac AC_OS_IRIX
-@maindex IRIX_SUN
+@maindex OS_IRIX
If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to @code{make}
variable @code{LIBS}. Needed to get @code{getmntent}. At sites using
Yellow Pages/NIS, it is also needed to get properly working
@end defmac
@defmac AC_OS_ISC
-@maindex ISC_POSIX
+@maindex OS_ISC
@vindex _POSIX_SOURCE
If on a POSIXized ISC UNIX, define @code{_POSIX_SOURCE} and add
@samp{-posix} (for the GNU C compiler) or @samp{-Xp} (for other C
@end defmac
@defmac AC_OS_MINIX
-@maindex MINIX
+@maindex OS_MINIX
@vindex _MINIX
@vindex _POSIX_SOURCE
@vindex _POSIX_1_SOURCE
@end defmac
@defmac AC_OS_SCO
-@maindex SCO_INTL
+@maindex OS_SCO
If on SCO UNIX, add @samp{-lintl} to @code{make} variable @code{LIBS}.
Used to get @code{strftime}. It must be called before checking for
@code{strftime}.
@end defmac
@defmac AC_OS_XENIX
-@maindex XENIX_DIR
-@vindex VOID_CLOSEDIR
-If on Xenix, define @code{VOID_CLOSEDIR} and add @samp{-lx} to
-@code{make} 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 must be called after
-@code{AC_HEADER_DIRENT}.
+@maindex OS_XENIX
+If on Xenix, add @samp{-lx} to @code{make} 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 must be
+called after @code{AC_HEADER_DIRENT}.
@end defmac
@node General Purpose Macros, Manual Configuration, Specific Tests, Top
@end defmac
@defmac AC_INIT_PREPARE (@var{unique-file-in-source-dir})
-@maindex PREPARE
+@maindex INIT_PREPARE
Find the source code directory and set up shell variables necessary for
other Autoconf macros to work. @var{unique-file-in-source-dir} is some
file that is in the package's source directory; @code{configure} checks
These macros check whether particular files exist.
@defmac AC_CHECK_LIB (@var{library} @r{[}, @var{action-if-found} @r{[}, @var{action-if-not-found} @r{[}, @var{other-libraries}@r{]]]})
-@maindex HAVE_LIBRARY
+@maindex CHECK_LIB
Create a test C program to see whether that program can be linked with
the library @var{library}. @var{action-if-found} is a list of shell
commands to run if the link succeeds (which means that the library is
@end defmac
@defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @var{value-if-found} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAM_CHECK
+@maindex CHECK_PROG
Check whether program @var{prog-to-check-for} exists in @code{PATH}. If
it is found, set @var{variable} to @var{value-if-found}, otherwise to
@var{value-if-not-found}, if given. If @var{variable} was already set,
@end defmac
@defmac AC_PATH_PROG (@var{variable}, @var{prog-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAM_PATH
+@maindex PATH_PROG
Similar to @code{AC_CHECK_PROG}, but set @var{variable} to the entire
path of @var{prog-to-check-for} if found. Otherwise, set @var{variable}
to @var{value-if-not-found}, if given. If @var{variable} was already
@end defmac
@defmac AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAMS_CHECK
+@maindex CHECK_PROGS
Check for each program in the whitespace-separated list
@var{progs-to-check-for} exists in @code{PATH}. If it is found, set
@var{variable} to the name of that program. Otherwise, continue
@end defmac
@defmac AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAMS_PATH
+@maindex PATH_PROGS
Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
are found, set @var{variable} to the entire pathname of the program
found.
@end defmac
@defmac AC_CHECK_FUNC (@var{function}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex FUNC_CHECK
+@maindex CHECK_FUNC
If @var{function} is available, run shell commands
@var{action-if-found}, otherwise @var{action-if-not-found}. If the
functions might be in libraries other than the default C library, first
@end defmac
@defmac AC_CHECK_FUNCS (@var{function}@dots{})
-@maindex HAVE_FUNCS
+@maindex CHECK_FUNCS
@vindex HAVE_@var{function}
For each given @var{function} in the whitespace-separated argument list
that is available, define @code{HAVE_@var{function}} (in all caps).
@end defmac
@defmac AC_CHECK_HEADERS (@var{header-file}@dots{})
-@maindex HAVE_HEADERS
+@maindex CHECK_HEADERS
@vindex HAVE_@var{header}
For each given system header file @var{header-file} in the
whitespace-separated argument list that exists, define
@end defmac
@defmac AC_CHECK_HEADER (@var{header-file}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex HEADER_CHECK
+@maindex CHECK_HEADER
If the system header file @var{header-file} exists, execute shell commands
@var{action-if-found}, otherwise execute @var{action-if-not-found}. If
you just want to define a symbol if the header file is available,
@end defmac
@defmac AC_EGREP_HEADER (@var{pattern}, @var{header-file}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex HEADER_EGREP
+@maindex EGREP_HEADER
If the output of running the preprocessor on the system header file
@var{header-file} contains the @code{egrep} regular expression
@var{pattern}, execute shell commands @var{action-if-found}, otherwise
@end defmac
@defmac AC_EGREP_CPP (@var{pattern}, @var{program}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex PROGRAM_EGREP
+@maindex EGREP_CPP
@var{program} is the text of a C or C++ program, on which shell variable and
backquote substitutions are performed. If the output of running the
preprocessor on @var{program} contains the @code{egrep} regular
@end defmac
@defmac AC_CHECK_SIZEOF (@var{type})
-@maindex SIZEOF_TYPE
+@maindex CHECK_SIZEOF
Define @code{SIZEOF_@var{uctype}} to be the size in bytes of the C (or
C++) builtin type @var{type}, e.g. @samp{int} or @samp{char *}. If
@samp{type} is unknown to the compiler, gets a size of 0. @var{uctype}
@end defmac
@defmac AC_TRY_CPP (@var{includes}, @var{action-if-true} @r{[}, @var{action-if-false}@r{]})
-@maindex TEST_CPP
+@maindex TRY_CPP
@var{includes} is C or C++ @code{#include} statements and declarations, on
which shell variable and backquote substitutions are performed.
(Actually, it can be any C program, but other statements are probably
callers change automatically.
@defmac AC_MSG_CHECKING (@var{feature-description})
-@maindex CHECKING
+@maindex MSG_CHECKING
Notify the user that @code{configure} is checking for a particular
feature. This macro prints a message that starts with @samp{checking }.
It prints nothing if @code{configure} is run with the @samp{--silent} or
@end defmac
@defmac AC_MSG_ERROR (@var{error-description})
-@maindex ERROR
+@maindex MSG_ERROR
Notify the user of an error that prevents @code{configure} from
completing. This macro prints an error message on the standard error
stream and exits @code{configure} with a nonzero status.
@end defmac
@defmac AC_MSG_RESULT (@var{result-description})
-@maindex VERBOSE
+@maindex MSG_RESULT
Notify the user of the results of a check. This information is
only printed if @code{configure} is run with the @samp{--verbose}
option. @var{result-description} should be something like @samp{setting
@end defmac
@defmac AC_MSG_WARN (@var{problem-description})
-@maindex WARN
+@maindex MSG_WARN
Notify the @code{configure} user of a possible problem. This macro
prints the message on the standard error stream; @code{configure}
continues running afterward, so macros that call @code{AC_MSG_WARN} should
@menu
* Macro Format:: Basic format of an Autoconf macro.
+* Macro Naming:: What to call your new macros.
* Quoting:: Protecting macros from unwanted expansion.
* Dependencies Between Macros:: What to do when macros depend on other macros.
* Checking for Files:: Finding whether a file exists.
* Multiple Cases:: Tests for several possible values.
@end menu
-@node Macro Format, Quoting, , Writing Macros
+@node Macro Format, Macro Naming, , Writing Macros
@section Macro Format
Autoconf macros are defined as arguments to the @code{m4} builtin
The square brackets here do not indicate optional text: they should
literally be present in the macro definition.
-All of the Autoconf macros have names starting with @samp{AC_} to
-prevent them from accidentally conflicting with other text. All shell
-variables that they use for internal purposes have names starting with
-@samp{ac_}. To ensure that your macros don't conflict with present or
-future Autoconf macros, you should prefix your own macro names and any
-shell variables they use with some other sequence. Possibilities
-include your initials, or an abbreviation for the name of your
-organization or software package.
-
The @code{m4} builtin @code{dnl} prevents a newline from being inserted
in the output where the macro is defined; without it, the generated
@code{configure} script would begin with dozens of blank lines.
@xref{Definitions, , How to define new macros, m4.info, GNU m4}, for
more complete information on writing @code{m4} macros.
-@node Quoting, Dependencies Between Macros, Macro Format, Writing Macros
+@node Macro Naming, Quoting, Macro Format, Writing Macros
+@section Macro Naming
+
+All of the Autoconf macros have all-uppercase names starting with
+@samp{AC_} to prevent them from accidentally conflicting with other
+text. All shell variables that they use for internal purposes have
+mostly-lowercase names starting with @samp{ac_}. To ensure that your
+macros don't conflict with present or future Autoconf macros, you should
+prefix your own macro names and any shell variables they use with some
+other sequence. Possibilities include your initials, or an abbreviation
+for the name of your organization or software package.
+
+Most of the Autoconf macros' names follow a structured naming convention
+that indicates the kind of feature check by the name. The macro names
+consist of several words, separated by underscores, going from most
+general to most specific. The names of their cache variables use the
+same convention (@pxref{Cache Variables}, for more information on them).
+
+The first word of the name after @samp{AC_} usually tells the category
+of feature being tested. Here are the categories for specific test
+macros, the kind of macro that you are more likely to write. You are
+not required to use these names, but consistency helps readability.
+
+@table @code
+@item C
+C language builtin features.
+@item DECL
+Declarations of C variables in header files.
+@item FUNC
+Functions in libraries.
+@item HEADER
+Header files.
+@item OS
+Quirks of particular operating systems.
+@item PATH
+The full path names to files.
+@item PROG
+The names of programs.
+@item STRUCT
+Definitions of C structures in header files.
+@item SYS
+Operating system features.
+@item TYPE
+C builtin or declared types.
+@end table
+
+After the category comes the name of the particular feature being
+tested. Any further words in the macro name indicate particular aspects
+of the feature. For example, @code{AC_FUNC_UTIME_NULL} checks the
+behavior of the @code{utime} function when called with a @code{NULL}
+pointer.
+
+@node Quoting, Dependencies Between Macros, Macro Naming, Writing Macros
@section Quoting
Macros that are called by other macros are evaluated by @code{m4}
quoting before the code that uses brackets, like this:
@example
-changequote(,)dnl
+changequote(, )dnl
@end example
@noindent
@code{changequote}:
@example
-changequote([,])dnl
+changequote([, ])dnl
@end example
When you create a @code{configure} script using newly written macros,
those checks. As a result, @code{configure} can run much faster than if
it had to perform all of the checks every time.
+@defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})
+@maindex CACHE_VAL
+Ensure that the results of the check identified by @var{cache-id} are
+available. If the results of the check were in the cache file that was
+read, print a verbose message saying so; otherwise, run the shell
+commands @var{commands-to-set-it}. Those commands should have no side
+effects except for setting the variable @var{cache-id}. In particular,
+they should not call @code{AC_DEFINE}; the code that follows the call to
+@code{AC_CACHE_VAL} should do that, based on the cached value. Also,
+they should not print any messages, for example with @code{AC_MSG_CHECKING};
+do that before calling @code{AC_CACHE_VAL}, so the messages are printed
+regardless of whether the results of the check are retrieved from the
+cache or determined by running the shell commands. If the shell
+commands are run to determine the value, the value will be saved in the
+cache file just before @code{configure} creates its output files.
+@end defmac
+
+@menu
+* Cache Files:: Files @code{configure} uses for caching.
+* Cache Variables:: Shell variables used in caches.
+@end menu
+
+@node Cache Files, Cache Variables, , Caching Values
+@section Cache Files
+
The cache file is a shell script that caches the results of configure
tests run on one system so they can be shared between configure scripts
and configure runs. It is not useful on other systems. If its contents
site-wide cache file to use instead of the default, to make it work
transparently (@pxref{Site Default Values}).
-@defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})
-@maindex CACHE_VAL
-Ensure that the results of the check identified by @var{cache-id} are
-available. If the results of the check were in the cache file that was
-read, print a verbose message saying so; otherwise, run the shell
-commands @var{commands-to-set-it}. Those commands should have no side
-effects except for setting the variable @var{cache-id}. In particular,
-they should not call @code{AC_DEFINE}; the code that follows the call to
-@code{AC_CACHE_VAL} should do that, based on the cached value. Also,
-they should not print any messages, for example with @code{AC_MSG_CHECKING};
-do that before calling @code{AC_CACHE_VAL}, so the messages are printed
-regardless of whether the results of the check are retrieved from the
-cache or determined by running the shell commands. If the shell
-commands are run to determine the value, the value will be saved in the
-cache file just before @code{configure} creates its output files.
+@node Cache Variables, , Cache Files, Caching Values
+@section Cache Variables
-@noindent
-The names of cache variables should have this format:
+The names of cache variables should have the following format:
@example
@var{package-prefix}_cv_@var{value-type}_@var{specific-value}@r{[}_@var{additional-options}@r{]}
a few restrictions. The values may not contain single quotes or curly braces.
Usually, their values will be boolean (@samp{yes} or @samp{no}) or the
names of files or functions; so this is not an important restriction.
-@end defmac
@node Makefiles, Invoking configure, Caching Values, Top
@chapter Makefiles
macros that were renamed, followed by the current names of those macros.
Although the old names are still accepted by the @code{autoconf} program
for backward compatibility, the old names are considered obsolete.
+@xref{Macro Naming}, for a description of the new naming scheme.
@table @code
@item AC_NOTICE
@vindex PROGRAM_EGREP
@vindex EGREP_CPP
@code{AC_EGREP_CPP}
-@vindex TRY_LINK
-@code{AC_TRY_LINK}
@item AC_TEST_PROGRAM
@vindex TEST_PROGRAM
@vindex TRY_RUN
@vindex MAJOR_HEADER
@vindex HEADER_MAJOR
@code{AC_HEADER_MAJOR}
-@item AC_DIR_HEADER
-@vindex DIR_HEADER
-@vindex HEADER_DIRENT
-@code{AC_HEADER_DIRENT}
@item AC_STAT_MACROS_BROKEN
@vindex STAT_MACROS_BROKEN
@vindex HEADER_STAT
# Files that can be generated, but should be up to date for a distribution.
DISTDEP = info Makefile
# Files to distribute.
-DISTFILES = COPYING ChangeLog INSTALL Makefile.in NEWS README \
+DISTFILES = COPYING ChangeLog INSTALL Makefile.in NEWS README TODO \
acconfig.h acfunctions acgeneral.m4 acheaders acidentifiers \
acmakevars acoldnames.m4 acprograms acspecific.m4 autoconf.info* \
autoconf.sh autoconf.texi install.texi \
config.status: configure
./config.status --recheck
-# FIXME this doesn't work.
clean mostlyclean distclean realclean::
for dir in $(SUBDIRS); do \
echo making $@ in $$dir ; \
(cd $$dir; $(MAKE) $@) ; \
done
-clean::
+clean mostlyclean distclean realclean::
rm -f autoconf autoheader autoscan autoreconf autoupdate
rm -f shindent ifnames *.tmp
rm -f *.aux *.cp *.cps *.dvi *.fn *.fns *.ky *.kys *.log
rm -f *.pg *.pgs *.toc *.tp *.tps *.vr *.vrs *.ma *.mas
-mostlyclean:: clean
-
-distclean:: clean
+distclean realclean::
rm -f Makefile config.status config.cache config.log
-realclean:: distclean
+realclean::
rm -f TAGS *.info* INSTALL
TAGS:
@c @setchapternewpage odd
@c %**end of header
-@set EDITION 1.96
-@set VERSION 1.96
+@set EDITION 1.97
+@set VERSION 1.97
@set UPDATED August 1994
@iftex
Writing Macros
* Macro Format:: Basic format of an Autoconf macro.
+* Macro Naming:: What to call your new macros.
* Quoting:: Protecting macros from unwanted expansion.
* Dependencies Between Macros:: What to do when macros depend on other macros.
* Checking for Files:: Finding whether a file exists.
* Guidelines:: General rules for writing test programs.
* Tricks:: Special ways to work around problems.
+Caching Values
+
+* Cache Files:: Files @code{configure} uses for caching.
+* Cache Variables:: Shell variables used in caches.
+
Makefiles
* Predefined Variables:: Heavily used @code{make} variables.
The @code{autoupdate} program updates a @file{configure.in} file that
calls Autoconf macros by their old names to use the current macro names.
In version 2 of Autoconf, most of the macros were renamed to use a more
-uniform and descriptive naming scheme. Although the old names still
-work (@pxref{Old Macro Names}, for a list of the old macro names and the
+uniform and descriptive naming scheme. @xref{Macro Naming}, for a
+description of the new scheme. Although the old names still work
+(@pxref{Old Macro Names}, for a list of the old macro names and the
corresponding new names), you can make your @file{configure.in} files
more readable and make it easier to use the current Autoconf
documentation if you update them to use the new macro names.
programs:
@defmac AC_PROG_GCC_TRADITIONAL
-@maindex GCC_TRADITIONAL
+@maindex PROG_GCC_TRADITIONAL
Add @samp{-traditional} to @code{make} variable @code{CC} if using the
GNU C compiler and @code{ioctl} does not work properly without
@samp{-traditional}. This macro calls @code{AC_PROG_CC} and
@end defmac
@defmac AC_PROG_LN_S
-@maindex LN_S
+@maindex PROG_LN_S
If @samp{ln -s} works on the current filesystem (the operating system
and filesystem support symbolic links), set shell and @code{make}
variable @code{LN_S} to @samp{ln -s}, otherwise set it to @samp{ln}.
@end defmac
@defmac AC_PROG_CC_C_O
-@maindex MINUS_C_MINUS_O
+@maindex PROG_CC_C_O
@vindex NO_MINUS_C_MINUS_O
If the C compiler does not accept the @samp{-c} and @samp{-o} options
simultaneously, define @code{NO_MINUS_C_MINUS_O}.
@end defmac
@defmac AC_PROG_RSH
-@maindex RSH
+@maindex PROG_RSH
@vindex RSH
@vindex NO_REMOTE
@vindex HAVE_NETDB_H
@end defmac
@defmac AC_PROG_MAKE_SET
-@maindex SET_MAKE
+@maindex PROG_MAKE_SET
If @code{make} predefines the variable @code{MAKE}, define @code{make}
variable @code{SET_MAKE} to be empty. Otherwise, define @code{SET_MAKE}
to contain @samp{MAKE=make}. Calls @code{AC_SUBST} for @code{SET_MAKE}.
@end defmac
@defmac AC_DECL_YYTEXT
-@maindex YYTEXT_POINTER
+@maindex DECL_YYTEXT
@vindex YYTEXT_POINTER
Define @code{YYTEXT_POINTER} if @code{yytext} is a @samp{char *} instead
of a @samp{char []}. This depends on whether @code{lex} or @code{flex}
The following macros check for the presence of certain C header files:
-@defmac AC_HEADER_DIRENT
+@defmac AC_DIR_HEADER
@maindex DIR_HEADER
@vindex DIRENT
-@vindex HAVE_DIRENT_H
-@vindex HAVE_NDIR_H
-@vindex HAVE_SYS_DIR_H
-@vindex HAVE_SYS_NDIR_H
@vindex SYSDIR
@vindex SYSNDIR
@vindex NDIR
@vindex VOID_CLOSEDIR
-Check for the the following header files, and for the first one that is
-found, define the listed macros (the second macros listed are for
-backward compatibility, and are considered obsolete):
+Like @code{AC_HEADER_DIRENT}, but defines a different set of C
+preprocessor macros to indicate which header file is found. This macro
+and the names it defines are considered obsolete. The names it defines are:
@table @file
@item dirent.h
-Define @code{HAVE_DIRENT_H} and @code{DIRENT}.
+@code{DIRENT}
@item sys/ndir.h
-Define @code{HAVE_SYS_NDIR_H} and @code{SYSNDIR}.
+@code{SYSNDIR}
@item sys/dir.h
-Define @code{HAVE_SYS_DIR_H} and @code{SYSDIR}.
+@code{SYSDIR}
@item ndir.h
-Define @code{HAVE_NDIR_H} and @code{NDIR}.
+@code{NDIR}
@end table
Also, if the directory library header file contains a declaration of the
@code{closedir} function with a @code{void} return type, define
@code{VOID_CLOSEDIR}.
+@end defmac
+
+@defmac AC_HEADER_DIRENT
+@maindex HEADER_DIRENT
+@vindex HAVE_DIRENT_H
+@vindex HAVE_NDIR_H
+@vindex HAVE_SYS_DIR_H
+@vindex HAVE_SYS_NDIR_H
+@vindex CLOSEDIR_VOID
+Check for the the following header files, and for the first one that is
+found, define the listed C preprocessor macro:
+
+@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
+
+Also, if the directory library header file contains a declaration of the
+@code{closedir} function with a @code{void} return type, define
+@code{CLOSEDIR_VOID}.
The directory library declarations in the source code should look
something like the following, which assumes that you have also called
@end defmac
@defmac AC_HEADER_MAJOR
-@maindex MAJOR_HEADER
+@maindex HEADER_MAJOR
@vindex MAJOR_IN_MKDEV
@vindex MAJOR_IN_SYSMACROS
If @file{sys/types.h} does not define @code{major}, @code{minor}, and
@end defmac
@defmac AC_HEADER_STDC
-@maindex STDC_HEADERS
+@maindex HEADER_STDC
@vindex STDC_HEADERS
Define @code{STDC_HEADERS} if the system has ANSI C header files.
Specifically, this macro checks for @file{stdlib.h}, @file{stdarg.h},
@end defmac
@defmac AC_DECL_SYS_SIGLIST
-@maindex SYS_SIGLIST_DECLARED
+@maindex DECL_SYS_SIGLIST
@vindex SYS_SIGLIST_DECLARED
Define @code{SYS_SIGLIST_DECLARED} if the variable @code{sys_siglist} is
declared in a system header file, either @file{signal.h} or
The following macros check for predefined C types:
@defmac AC_TYPE_GETGROUPS
-@maindex GETGROUPS_T
+@maindex TYPE_GETGROUPS
@vindex GETGROUPS_T
Define @code{GETGROUPS_T} to be whichever of @code{gid_t} or @code{int}
is the base type of the array argument to @code{getgroups}.
@end defmac
@defmac AC_TYPE_MODE_T
-@maindex MODE_T
+@maindex TYPE_MODE_T
@vindex mode_t
If @code{mode_t} is not defined in @file{sys/types.h}, define
@code{mode_t} to be @code{int}.
@end defmac
@defmac AC_TYPE_OFF_T
-@maindex OFF_T
+@maindex TYPE_OFF_T
@vindex off_t
If @code{off_t} is not defined in @file{sys/types.h}, define
@code{off_t} to be @code{long}.
@end defmac
@defmac AC_TYPE_PID_T
-@maindex PID_T
+@maindex TYPE_PID_T
@vindex pid_t
If @code{pid_t} is not defined in @file{sys/types.h}, define
@code{pid_t} to be @code{int}.
@end defmac
@defmac AC_TYPE_SIGNAL
-@maindex RETSIGTYPE
+@maindex TYPE_SIGNAL
@vindex RETSIGTYPE
If @file{signal.h} declares @code{signal} as returning a pointer to a
function returning @code{void}, define @code{RETSIGTYPE} to be
@end defmac
@defmac AC_TYPE_SIZE_T
-@maindex SIZE_T
+@maindex TYPE_SIZE_T
@vindex size_t
If @code{size_t} is not defined in @file{sys/types.h}, define
@code{size_t} to be @code{unsigned}.
@end defmac
@defmac AC_TYPE_UID_T
-@maindex UID_T
+@maindex TYPE_UID_T
@vindex uid_t
@vindex gid_t
If @code{uid_t} is not defined in @file{sys/types.h}, define
The following macros check for particular C library functions:
@defmac AC_FUNC_ALLOCA
-@maindex ALLOCA
+@maindex FUNC_ALLOCA
@vindex C_ALLOCA
@vindex HAVE_ALLOCA_H
Check how to get @code{alloca}. Tries to get a builtin version by
@end defmac
@defmac AC_FUNC_GETLOADAVG
-@maindex GETLOADAVG
+@maindex FUNC_GETLOADAVG
@vindex SVR4
@vindex DGUX
@vindex UMAX
@end defmac
@defmac AC_FUNC_MMAP
-@maindex MMAP
+@maindex FUNC_MMAP
@vindex HAVE_MMAP
If the @code{mmap} function exists and works correctly, define
@code{HAVE_MMAP}.
@end defmac
@defmac AC_FUNC_SETVBUF_REVERSED
-@maindex SETVBUF_REVERSED
+@maindex FUNC_SETVBUF_REVERSED
@vindex SETVBUF_REVERSED
If @code{setvbuf} takes the buffering type as its second argument and
the buffer pointer as the third, instead of the other way around, define
@end defmac
@defmac AC_FUNC_STRCOLL
-@maindex STRCOLL
+@maindex FUNC_STRCOLL
@vindex HAVE_STRCOLL
If the @code{strcoll} function exists and works correctly, define
@code{HAVE_STRCOLL}. This does a bit more than
@end defmac
@defmac AC_FUNC_UTIME_NULL
-@maindex UTIME_NULL
+@maindex FUNC_UTIME_NULL
@vindex HAVE_UTIME_NULL
If @samp{utime(@var{file}, NULL)} sets @var{file}'s timestamp to
the present, define @code{HAVE_UTIME_NULL}.
@end defmac
@defmac AC_FUNC_VFORK
-@maindex VFORK
+@maindex FUNC_VFORK
@vindex HAVE_VFORK_H
@vindex vfork
If @file{vfork.h} is found, define @code{HAVE_VFORK_H}. If a working
@end defmac
@defmac AC_FUNC_VPRINTF
-@maindex VPRINTF
+@maindex FUNC_VPRINTF
@vindex HAVE_VPRINTF
@vindex HAVE_DOPRNT
If @code{vprintf} is found, define @code{HAVE_VPRINTF}. Otherwise, if
@end defmac
@defmac AC_FUNC_WAIT3
-@maindex WAIT3
+@maindex FUNC_WAIT3
@vindex HAVE_WAIT3
If @code{wait3} is found and fills in the contents of its third argument
(a @samp{struct rusage *}), which HP-UX does not do, define
The following macros check for certain structures or structure members:
@defmac AC_HEADER_STAT
-@maindex STAT_MACROS_BROKEN
+@maindex HEADER_STAT
@maindex STAT_MACROS_BROKEN
If the macros @code{S_ISDIR}, @code{S_ISREG} et al. defined in
@file{sys/stat.h} do not work properly (returning false positives),
@end defmac
@defmac AC_STRUCT_ST_BLKSIZE
-@maindex ST_BLKSIZE
+@maindex STRUCT_ST_BLKSIZE
@vindex HAVE_ST_BLKSIZE
If @code{struct stat} contains an @code{st_blksize} member, define
@code{HAVE_ST_BLKSIZE}.
@end defmac
@defmac AC_STRUCT_ST_BLOCKS
-@maindex ST_BLOCKS
+@maindex STRUCT_ST_BLOCKS
@vindex HAVE_ST_BLOCKS
If @code{struct stat} contains an @code{st_blocks} member, define
@code{HAVE_ST_BLOCKS}. Otherwise, add @samp{fileblocks.o} to the
@end defmac
@defmac AC_STRUCT_ST_RDEV
-@maindex ST_RDEV
+@maindex STRUCT_ST_RDEV
@vindex HAVE_ST_RDEV
If @code{struct stat} contains an @code{st_rdev} member, define
@code{HAVE_ST_RDEV}.
@end defmac
@defmac AC_HEADER_TIME
-@maindex TIME_WITH_SYS_TIME
+@maindex HEADER_TIME
@vindex TIME_WITH_SYS_TIME
If a program may include both @file{time.h} and @file{sys/time.h},
define @code{TIME_WITH_SYS_TIME}. On some older systems,
@end defmac
@defmac AC_STRUCT_TIMEZONE
-@maindex TIMEZONE
+@maindex STRUCT_TIMEZONE
@vindex HAVE_TM_ZONE
@vindex HAVE_TZNAME
Figure out how to get the current timezone. If @code{struct tm} has a
features:
@defmac AC_C_ARG_ARRAY
-@maindex ARG_ARRAY
+@maindex C_ARG_ARRAY
@vindex NO_ARG_ARRAY
If the address of an argument to a C function can not be used like
the start of an array, define @code{NO_ARG_ARRAY}. This ability allows
@end defmac
@defmac AC_TRY_CROSS
-@maindex CROSS_CHECK
+@maindex TRY_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
@defmac AC_C_CHAR_UNSIGNED
-@maindex CHAR_UNSIGNED
+@maindex C_CHAR_UNSIGNED
@vindex __CHAR_UNSIGNED__
If the C type @code{char} is unsigned, define @code{__CHAR_UNSIGNED__},
unless the C compiler predefines it.
@end defmac
@defmac AC_C_CONST
-@maindex CONST
+@maindex C_CONST
@vindex const
If the C compiler does not fully support the keyword @code{const},
define @code{const} to be empty. Some C compilers that do not define
@end defmac
@defmac AC_C_INLINE
-@maindex INLINE
+@maindex C_INLINE
@vindex inline
If the C compiler is a version of GCC that supports the keyword
@code{__inline} but not @code{inline} (such as some NeXT versions),
@end defmac
@defmac AC_C_LONG_DOUBLE
-@maindex HAVE_LONG_DOUBLE
+@maindex C_LONG_DOUBLE
@vindex HAVE_LONG_DOUBLE
If the C compiler supports the @code{long double} type, define
@code{HAVE_LONG_DOUBLE}. Some C compilers that do not define
@end defmac
@defmac AC_C_BIGENDIAN
-@maindex WORDS_BIGENDIAN
+@maindex C_BIGENDIAN
@vindex WORDS_BIGENDIAN
If words are stored with the most significant byte first (like Motorola
and SPARC, but not Intel and VAX, CPUs), define @code{WORDS_BIGENDIAN}.
The following macros check for operating system services:
@defmac AC_PATH_X
-@maindex FIND_X
+@maindex PATH_X
Try to locate the X Window System include files and libraries. Try
first by running @code{xmkmf} on a trivial @file{Imakefile} and
examining the @file{Makefile} that it produces. If that fails (such as
@end defmac
@defmac AC_PATH_XTRA
-@maindex FIND_XTRA
+@maindex PATH_XTRA
An enhanced version of @code{AC_PATH_X}. Put the C compiler flags that
X needs into @code{make} variable @code{X_CFLAGS}, and the X linker
flags into @code{X_LIBS}. If X is not available, put
you should let it call @code{AC_PATH_X} rather than doing that yourself.
@end defmac
-@defmac AC_HAVE_POUNDBANG (@var{action-if-supported} @r{[}, @var{action-if-not-supported}@r{]})
+@defmac AC_HAVE_POUNDBANG (@var{action-if-supported} @r{[},
+@var{action-if-not-supported}@r{]})
@maindex HAVE_POUNDBANG
Check whether the system supports starting shell scripts with a line of
the form @samp{#!/bin/csh} to select the shell to use. If @samp{#!}
@end defmac
@defmac AC_SYS_LONG_FILE_NAMES
-@maindex LONG_FILE_NAMES
+@maindex SYS_LONG_FILE_NAMES
@vindex HAVE_LONG_FILE_NAMES
If the system supports file names longer than 14 characters, define
@code{HAVE_LONG_FILE_NAMES}.
@end defmac
@defmac AC_SYS_REMOTE_TAPE
-@maindex REMOTE_TAPE
+@maindex SYS_REMOTE_TAPE
@vindex HAVE_SYS_MTIO_H
If BSD tape drive ioctls are available, define @code{HAVE_SYS_MTIO_H},
and if sockets are available add @code{rmt} to @code{make} variable
@end defmac
@defmac AC_SYS_RESTARTABLE_SYSCALLS
-@maindex RESTARTABLE_SYSCALLS
+@maindex SYS_RESTARTABLE_SYSCALLS
@vindex HAVE_RESTARTABLE_SYSCALLS
If the system automatically restarts a system call that is interrupted
by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}.
functions they make available or the environments they provide.
@defmac AC_OS_AIX
-@maindex AIX
+@maindex OS_AIX
@vindex _ALL_SOURCE
If on AIX, define @code{_ALL_SOURCE}. Allows the use of some BSD
functions. Should be called before any macros that run the C compiler.
@end defmac
@defmac AC_OS_DYNIX
-@maindex DYNIX_SEQ
+@maindex OS_DYNIX
If on DYNIX/ptx (Sequent UNIX), add @samp{-lseq} to @code{make}
variable @code{LIBS}. Allows use of some BSD system calls and
@code{getmntent}.
@end defmac
@defmac AC_OS_IRIX
-@maindex IRIX_SUN
+@maindex OS_IRIX
If on IRIX (Silicon Graphics UNIX), add @samp{-lsun} to @code{make}
variable @code{LIBS}. Needed to get @code{getmntent}. At sites using
Yellow Pages/NIS, it is also needed to get properly working
@end defmac
@defmac AC_OS_ISC
-@maindex ISC_POSIX
+@maindex OS_ISC
@vindex _POSIX_SOURCE
If on a POSIXized ISC UNIX, define @code{_POSIX_SOURCE} and add
@samp{-posix} (for the GNU C compiler) or @samp{-Xp} (for other C
@end defmac
@defmac AC_OS_MINIX
-@maindex MINIX
+@maindex OS_MINIX
@vindex _MINIX
@vindex _POSIX_SOURCE
@vindex _POSIX_1_SOURCE
@end defmac
@defmac AC_OS_SCO
-@maindex SCO_INTL
+@maindex OS_SCO
If on SCO UNIX, add @samp{-lintl} to @code{make} variable @code{LIBS}.
Used to get @code{strftime}. It must be called before checking for
@code{strftime}.
@end defmac
@defmac AC_OS_XENIX
-@maindex XENIX_DIR
-@vindex VOID_CLOSEDIR
-If on Xenix, define @code{VOID_CLOSEDIR} and add @samp{-lx} to
-@code{make} 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 must be called after
-@code{AC_HEADER_DIRENT}.
+@maindex OS_XENIX
+If on Xenix, add @samp{-lx} to @code{make} 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 must be
+called after @code{AC_HEADER_DIRENT}.
@end defmac
@node General Purpose Macros, Manual Configuration, Specific Tests, Top
@end defmac
@defmac AC_INIT_PREPARE (@var{unique-file-in-source-dir})
-@maindex PREPARE
+@maindex INIT_PREPARE
Find the source code directory and set up shell variables necessary for
other Autoconf macros to work. @var{unique-file-in-source-dir} is some
file that is in the package's source directory; @code{configure} checks
These macros check whether particular files exist.
@defmac AC_CHECK_LIB (@var{library} @r{[}, @var{action-if-found} @r{[}, @var{action-if-not-found} @r{[}, @var{other-libraries}@r{]]]})
-@maindex HAVE_LIBRARY
+@maindex CHECK_LIB
Create a test C program to see whether that program can be linked with
the library @var{library}. @var{action-if-found} is a list of shell
commands to run if the link succeeds (which means that the library is
@end defmac
@defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @var{value-if-found} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAM_CHECK
+@maindex CHECK_PROG
Check whether program @var{prog-to-check-for} exists in @code{PATH}. If
it is found, set @var{variable} to @var{value-if-found}, otherwise to
@var{value-if-not-found}, if given. If @var{variable} was already set,
@end defmac
@defmac AC_PATH_PROG (@var{variable}, @var{prog-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAM_PATH
+@maindex PATH_PROG
Similar to @code{AC_CHECK_PROG}, but set @var{variable} to the entire
path of @var{prog-to-check-for} if found. Otherwise, set @var{variable}
to @var{value-if-not-found}, if given. If @var{variable} was already
@end defmac
@defmac AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAMS_CHECK
+@maindex CHECK_PROGS
Check for each program in the whitespace-separated list
@var{progs-to-check-for} exists in @code{PATH}. If it is found, set
@var{variable} to the name of that program. Otherwise, continue
@end defmac
@defmac AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for} @r{[}, @var{value-if-not-found}@r{]})
-@maindex PROGRAMS_PATH
+@maindex PATH_PROGS
Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
are found, set @var{variable} to the entire pathname of the program
found.
@end defmac
@defmac AC_CHECK_FUNC (@var{function}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex FUNC_CHECK
+@maindex CHECK_FUNC
If @var{function} is available, run shell commands
@var{action-if-found}, otherwise @var{action-if-not-found}. If the
functions might be in libraries other than the default C library, first
@end defmac
@defmac AC_CHECK_FUNCS (@var{function}@dots{})
-@maindex HAVE_FUNCS
+@maindex CHECK_FUNCS
@vindex HAVE_@var{function}
For each given @var{function} in the whitespace-separated argument list
that is available, define @code{HAVE_@var{function}} (in all caps).
@end defmac
@defmac AC_CHECK_HEADERS (@var{header-file}@dots{})
-@maindex HAVE_HEADERS
+@maindex CHECK_HEADERS
@vindex HAVE_@var{header}
For each given system header file @var{header-file} in the
whitespace-separated argument list that exists, define
@end defmac
@defmac AC_CHECK_HEADER (@var{header-file}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex HEADER_CHECK
+@maindex CHECK_HEADER
If the system header file @var{header-file} exists, execute shell commands
@var{action-if-found}, otherwise execute @var{action-if-not-found}. If
you just want to define a symbol if the header file is available,
@end defmac
@defmac AC_EGREP_HEADER (@var{pattern}, @var{header-file}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex HEADER_EGREP
+@maindex EGREP_HEADER
If the output of running the preprocessor on the system header file
@var{header-file} contains the @code{egrep} regular expression
@var{pattern}, execute shell commands @var{action-if-found}, otherwise
@end defmac
@defmac AC_EGREP_CPP (@var{pattern}, @var{program}, @var{action-if-found} @r{[}, @var{action-if-not-found}@r{]})
-@maindex PROGRAM_EGREP
+@maindex EGREP_CPP
@var{program} is the text of a C or C++ program, on which shell variable and
backquote substitutions are performed. If the output of running the
preprocessor on @var{program} contains the @code{egrep} regular
@end defmac
@defmac AC_CHECK_SIZEOF (@var{type})
-@maindex SIZEOF_TYPE
+@maindex CHECK_SIZEOF
Define @code{SIZEOF_@var{uctype}} to be the size in bytes of the C (or
C++) builtin type @var{type}, e.g. @samp{int} or @samp{char *}. If
@samp{type} is unknown to the compiler, gets a size of 0. @var{uctype}
@end defmac
@defmac AC_TRY_CPP (@var{includes}, @var{action-if-true} @r{[}, @var{action-if-false}@r{]})
-@maindex TEST_CPP
+@maindex TRY_CPP
@var{includes} is C or C++ @code{#include} statements and declarations, on
which shell variable and backquote substitutions are performed.
(Actually, it can be any C program, but other statements are probably
callers change automatically.
@defmac AC_MSG_CHECKING (@var{feature-description})
-@maindex CHECKING
+@maindex MSG_CHECKING
Notify the user that @code{configure} is checking for a particular
feature. This macro prints a message that starts with @samp{checking }.
It prints nothing if @code{configure} is run with the @samp{--silent} or
@end defmac
@defmac AC_MSG_ERROR (@var{error-description})
-@maindex ERROR
+@maindex MSG_ERROR
Notify the user of an error that prevents @code{configure} from
completing. This macro prints an error message on the standard error
stream and exits @code{configure} with a nonzero status.
@end defmac
@defmac AC_MSG_RESULT (@var{result-description})
-@maindex VERBOSE
+@maindex MSG_RESULT
Notify the user of the results of a check. This information is
only printed if @code{configure} is run with the @samp{--verbose}
option. @var{result-description} should be something like @samp{setting
@end defmac
@defmac AC_MSG_WARN (@var{problem-description})
-@maindex WARN
+@maindex MSG_WARN
Notify the @code{configure} user of a possible problem. This macro
prints the message on the standard error stream; @code{configure}
continues running afterward, so macros that call @code{AC_MSG_WARN} should
@menu
* Macro Format:: Basic format of an Autoconf macro.
+* Macro Naming:: What to call your new macros.
* Quoting:: Protecting macros from unwanted expansion.
* Dependencies Between Macros:: What to do when macros depend on other macros.
* Checking for Files:: Finding whether a file exists.
* Multiple Cases:: Tests for several possible values.
@end menu
-@node Macro Format, Quoting, , Writing Macros
+@node Macro Format, Macro Naming, , Writing Macros
@section Macro Format
Autoconf macros are defined as arguments to the @code{m4} builtin
The square brackets here do not indicate optional text: they should
literally be present in the macro definition.
-All of the Autoconf macros have names starting with @samp{AC_} to
-prevent them from accidentally conflicting with other text. All shell
-variables that they use for internal purposes have names starting with
-@samp{ac_}. To ensure that your macros don't conflict with present or
-future Autoconf macros, you should prefix your own macro names and any
-shell variables they use with some other sequence. Possibilities
-include your initials, or an abbreviation for the name of your
-organization or software package.
-
The @code{m4} builtin @code{dnl} prevents a newline from being inserted
in the output where the macro is defined; without it, the generated
@code{configure} script would begin with dozens of blank lines.
@xref{Definitions, , How to define new macros, m4.info, GNU m4}, for
more complete information on writing @code{m4} macros.
-@node Quoting, Dependencies Between Macros, Macro Format, Writing Macros
+@node Macro Naming, Quoting, Macro Format, Writing Macros
+@section Macro Naming
+
+All of the Autoconf macros have all-uppercase names starting with
+@samp{AC_} to prevent them from accidentally conflicting with other
+text. All shell variables that they use for internal purposes have
+mostly-lowercase names starting with @samp{ac_}. To ensure that your
+macros don't conflict with present or future Autoconf macros, you should
+prefix your own macro names and any shell variables they use with some
+other sequence. Possibilities include your initials, or an abbreviation
+for the name of your organization or software package.
+
+Most of the Autoconf macros' names follow a structured naming convention
+that indicates the kind of feature check by the name. The macro names
+consist of several words, separated by underscores, going from most
+general to most specific. The names of their cache variables use the
+same convention (@pxref{Cache Variables}, for more information on them).
+
+The first word of the name after @samp{AC_} usually tells the category
+of feature being tested. Here are the categories for specific test
+macros, the kind of macro that you are more likely to write. You are
+not required to use these names, but consistency helps readability.
+
+@table @code
+@item C
+C language builtin features.
+@item DECL
+Declarations of C variables in header files.
+@item FUNC
+Functions in libraries.
+@item HEADER
+Header files.
+@item OS
+Quirks of particular operating systems.
+@item PATH
+The full path names to files.
+@item PROG
+The names of programs.
+@item STRUCT
+Definitions of C structures in header files.
+@item SYS
+Operating system features.
+@item TYPE
+C builtin or declared types.
+@end table
+
+After the category comes the name of the particular feature being
+tested. Any further words in the macro name indicate particular aspects
+of the feature. For example, @code{AC_FUNC_UTIME_NULL} checks the
+behavior of the @code{utime} function when called with a @code{NULL}
+pointer.
+
+@node Quoting, Dependencies Between Macros, Macro Naming, Writing Macros
@section Quoting
Macros that are called by other macros are evaluated by @code{m4}
quoting before the code that uses brackets, like this:
@example
-changequote(,)dnl
+changequote(, )dnl
@end example
@noindent
@code{changequote}:
@example
-changequote([,])dnl
+changequote([, ])dnl
@end example
When you create a @code{configure} script using newly written macros,
those checks. As a result, @code{configure} can run much faster than if
it had to perform all of the checks every time.
+@defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})
+@maindex CACHE_VAL
+Ensure that the results of the check identified by @var{cache-id} are
+available. If the results of the check were in the cache file that was
+read, print a verbose message saying so; otherwise, run the shell
+commands @var{commands-to-set-it}. Those commands should have no side
+effects except for setting the variable @var{cache-id}. In particular,
+they should not call @code{AC_DEFINE}; the code that follows the call to
+@code{AC_CACHE_VAL} should do that, based on the cached value. Also,
+they should not print any messages, for example with @code{AC_MSG_CHECKING};
+do that before calling @code{AC_CACHE_VAL}, so the messages are printed
+regardless of whether the results of the check are retrieved from the
+cache or determined by running the shell commands. If the shell
+commands are run to determine the value, the value will be saved in the
+cache file just before @code{configure} creates its output files.
+@end defmac
+
+@menu
+* Cache Files:: Files @code{configure} uses for caching.
+* Cache Variables:: Shell variables used in caches.
+@end menu
+
+@node Cache Files, Cache Variables, , Caching Values
+@section Cache Files
+
The cache file is a shell script that caches the results of configure
tests run on one system so they can be shared between configure scripts
and configure runs. It is not useful on other systems. If its contents
site-wide cache file to use instead of the default, to make it work
transparently (@pxref{Site Default Values}).
-@defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})
-@maindex CACHE_VAL
-Ensure that the results of the check identified by @var{cache-id} are
-available. If the results of the check were in the cache file that was
-read, print a verbose message saying so; otherwise, run the shell
-commands @var{commands-to-set-it}. Those commands should have no side
-effects except for setting the variable @var{cache-id}. In particular,
-they should not call @code{AC_DEFINE}; the code that follows the call to
-@code{AC_CACHE_VAL} should do that, based on the cached value. Also,
-they should not print any messages, for example with @code{AC_MSG_CHECKING};
-do that before calling @code{AC_CACHE_VAL}, so the messages are printed
-regardless of whether the results of the check are retrieved from the
-cache or determined by running the shell commands. If the shell
-commands are run to determine the value, the value will be saved in the
-cache file just before @code{configure} creates its output files.
+@node Cache Variables, , Cache Files, Caching Values
+@section Cache Variables
-@noindent
-The names of cache variables should have this format:
+The names of cache variables should have the following format:
@example
@var{package-prefix}_cv_@var{value-type}_@var{specific-value}@r{[}_@var{additional-options}@r{]}
a few restrictions. The values may not contain single quotes or curly braces.
Usually, their values will be boolean (@samp{yes} or @samp{no}) or the
names of files or functions; so this is not an important restriction.
-@end defmac
@node Makefiles, Invoking configure, Caching Values, Top
@chapter Makefiles
macros that were renamed, followed by the current names of those macros.
Although the old names are still accepted by the @code{autoconf} program
for backward compatibility, the old names are considered obsolete.
+@xref{Macro Naming}, for a description of the new naming scheme.
@table @code
@item AC_NOTICE
@vindex PROGRAM_EGREP
@vindex EGREP_CPP
@code{AC_EGREP_CPP}
-@vindex TRY_LINK
-@code{AC_TRY_LINK}
@item AC_TEST_PROGRAM
@vindex TEST_PROGRAM
@vindex TRY_RUN
@vindex MAJOR_HEADER
@vindex HEADER_MAJOR
@code{AC_HEADER_MAJOR}
-@item AC_DIR_HEADER
-@vindex DIR_HEADER
-@vindex HEADER_DIRENT
-@code{AC_HEADER_DIRENT}
@item AC_STAT_MACROS_BROKEN
@vindex STAT_MACROS_BROKEN
@vindex HEADER_STAT
ifdef([__gnu__], , [errprint(Autoconf requires GNU m4
)m4exit(2)])dnl
dnl
-define(AC_ACVERSION, 1.96)dnl
+define(AC_ACVERSION, 1.97)dnl
dnl This is defined by the --version option of the autoconf script.
ifdef([AC_PRINT_VERSION], [Autoconf version AC_ACVERSION
m4exit(0)])dnl
changequote(, )dnl
ac_usage="Usage: configure [options] [host]
Options: [defaults in brackets after descriptions]
---build=BUILD configure for building on BUILD [BUILD=HOST]
+Configuration:
--cache-file=FILE cache test results in FILE
---disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
---enable-FEATURE[=ARG] include FEATURE [ARG=yes]
---exec-prefix=PREFIX install host dependent files in PREFIX [/usr/local]
--help print this message
---host=HOST configure for HOST [guessed]
--no-create do not create output files
---prefix=PREFIX install host independent files in PREFIX [/usr/local]
--quiet, --silent do not print \`checking for...' messages
---srcdir=DIR find the sources in DIR [configure dir or ..]
---target=TARGET configure for TARGET [TARGET=HOST]
--verbose print results of checks
--version print the version of autoconf that created configure
+Directories:
+--exec-prefix=PREFIX install host dependent files in PREFIX [/usr/local]
+--prefix=PREFIX install host independent files in PREFIX [/usr/local]
+--srcdir=DIR find the sources in DIR [configure dir or ..]
+Host type:
+--build=BUILD configure for building on BUILD [BUILD=HOST]
+--host=HOST configure for HOST [guessed]
+--target=TARGET configure for TARGET [TARGET=HOST]
+Features and packages:
+--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
+--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--x-includes=DIR X include files are in DIR
for ac_site_dir in $ac_site_dirs; do
ac_site_file=$ac_site_dir/lib/config.site
if test -r "$ac_site_file"; then
- AC_MSG_RESULT(loading site initialization script $ac_site_file)
+ echo "loading site initialization script $ac_site_file"
. $ac_site_file
fi
done
dnl
define(AC_CACHE_LOAD,
[if test -r "$cache_file"; then
- AC_MSG_RESULT(loading test results from cache file $cache_file)
+ echo "loading test results from cache file $cache_file"
. $cache_file
else
- AC_MSG_RESULT(creating new cache file $cache_file)
+ echo "creating new cache file $cache_file"
> $cache_file
fi])dnl
dnl
define(AC_CACHE_SAVE,
[if test -w $cache_file; then
-AC_MSG_RESULT(saving test results in cache file $cache_file)
+echo "saving test results in cache file $cache_file"
cat > $cache_file <<\CEOF
# This file is a shell script that caches the results of configure
# tests run on this system so they can be shared between configure
cat >> ${CONFIG_STATUS} <<\EOF
ac_given_srcdir=$srcdir
+ac_given_INSTALL=$INSTALL
CONFIG_FILES=${CONFIG_FILES-"$1"}
for ac_file in .. ${CONFIG_FILES}; do if test "x$ac_file" != x..; then
# The file is in a subdirectory.
test ! -d "$ac_dir" && mkdir "$ac_dir"
ac_dir_suffix="/$ac_dir"
+ # A "../" for each directory in $ac_dir_suffix.
+changequote(, )dnl
+ ac_dots=`echo $ac_dir_suffix|sed 's%/[^/]*%../%g'`
+changequote([, ])dnl
else
- ac_dir_suffix=
+ ac_dir_suffix= ac_dots=
fi
-changequote(, )dnl
- # A "../" for each directory in $ac_dir_suffix.
- ac_dots=`echo $ac_dir_suffix|sed 's%/[^/]*%../%g'`
-changequote([, ])dnl
case "$ac_given_srcdir" in
.) srcdir=.
- if test -z "$ac_dir_suffix"; then top_srcdir=.
+ if test -z "$ac_dots"; then top_srcdir=.
else top_srcdir=`echo $ac_dots|sed 's%/$%%'`; fi ;;
/*) srcdir="$ac_given_srcdir$ac_dir_suffix"; top_srcdir="$ac_given_srcdir" ;;
*) # Relative path.
top_srcdir="$ac_dots$ac_given_srcdir" ;;
esac
+ case "$ac_given_INSTALL" in
+changequote(, )dnl
+ [/$]*) INSTALL="$ac_given_INSTALL" ;;
+changequote([, ])dnl
+ *) INSTALL="$ac_dots$ac_given_INSTALL" ;;
+ esac
+
echo creating "$ac_file"
rm -f "$ac_file"
comment_str="Generated automatically from `echo $ac_file|sed 's|.*/||'`.in by configure."
RTAPELIB=rtapelib.o
else
AC_MSG_RESULT(found no remote shell)
- AC_CHECK_HEADER(netdb.h, RTAPELIB=rtapelib.o AC_DEFINE(HAVE_NETDB_H),
- RTAPELIB= AC_DEFINE(NO_REMOTE))
+ AC_CHECK_HEADER(netdb.h, [RTAPELIB=rtapelib.o AC_DEFINE(HAVE_NETDB_H)],
+ [RTAPELIB= AC_DEFINE(NO_REMOTE)])
fi
AC_SUBST(RSH)dnl
AC_SUBST(RTAPELIB)dnl
done])dnl
case "$ac_cv_header_dir" in
-dirent.h) AC_DEFINE(DIRENT)
-AC_DEFINE(HAVE_DIRENT_H) ;;
-sys/ndir.h) AC_DEFINE(SYSNDIR)
-AC_DEFINE(HAVE_SYS_NDIR_H) ;;
-sys/dir.h) AC_DEFINE(SYSDIR)
-AC_DEFINE(HAVE_SYS_DIR_H) ;;
-ndir.h) AC_DEFINE(NDIR)
-AC_DEFINE(HAVE_NDIR_H) ;;
+dirent.h) AC_DEFINE(HAVE_DIRENT_H) ;;
+sys/ndir.h) AC_DEFINE(HAVE_SYS_NDIR_H) ;;
+sys/dir.h) AC_DEFINE(HAVE_SYS_DIR_H) ;;
+ndir.h) AC_DEFINE(HAVE_NDIR_H) ;;
+esac
+
+AC_MSG_CHECKING(for closedir return value)
+AC_CACHE_VAL(ac_cv_func_closedir_void,
+[AC_TRY_RUN([#include <sys/types.h>
+#include <$ac_cv_header_dir>
+int closedir(); main() { exit(closedir(opendir(".")) != 0); }],
+ ac_cv_func_closedir_void=no, ac_cv_func_closedir_void=yes)])dnl
+if test $ac_cv_func_closedir_void = yes; then
+ AC_DEFINE(CLOSEDIR_VOID)
+fi
+])dnl
+dnl
+dnl Obsolete.
+define(AC_DIR_HEADER,
+[AC_PROVIDE([$0])dnl
+AC_MSG_CHECKING(for directory library header)
+AC_CACHE_VAL(ac_cv_header_dir,
+[ac_cv_header_dir=no
+for ac_hdr in dirent.h sys/ndir.h sys/dir.h ndir.h; do
+ AC_MSG_CHECKING([for $ac_hdr])
+AC_TRY_LINK([#include <sys/types.h>
+#include <$ac_hdr>], [DIR *dirp = 0;], ac_cv_header_dir=$ac_hdr; break)
+done])dnl
+
+case "$ac_cv_header_dir" in
+dirent.h) AC_DEFINE(DIRENT) ;;
+sys/ndir.h) AC_DEFINE(SYSNDIR) ;;
+sys/dir.h) AC_DEFINE(SYSDIR) ;;
+ndir.h) AC_DEFINE(NDIR) ;;
esac
AC_MSG_CHECKING(for closedir return value)
Makefile: Makefile.in ../config.status
cd ..; ./config.status
-clean:
+clean mostlyclean distclean realclean::
rm -f autoconf.log autoconf.sum site.exp site.bak AC* confdummy*
-mostlyclean: clean
-
-distclean: clean
+distclean realclean::
rm -f Makefile config.status config.cache config.log
-realclean: distclean
-
TAGS:
projects / thirdparty / autoconf.git / commitdiff
