autoconf: Input
1
1 4.4 Finding `configure' Input
1 =============================
1
1 -- Macro: AC_CONFIG_SRCDIR (UNIQUE-FILE-IN-SOURCE-DIR)
1 UNIQUE-FILE-IN-SOURCE-DIR is some file that is in the package's
1 source directory; `configure' checks for this file's existence to
1 make sure that the directory that it is told contains the source
1 code in fact does. Occasionally people accidentally specify the
11 wrong directory with `--srcdir'; this is a safety check. ⇒
configure Invocation, for more information.
1
1 Packages that do manual configuration or use the `install' program
1 might need to tell `configure' where to find some other shell scripts
1 by calling `AC_CONFIG_AUX_DIR', though the default places it looks are
1 correct for most cases.
1
1 -- Macro: AC_CONFIG_AUX_DIR (DIR)
1 Use the auxiliary build tools (e.g., `install-sh', `config.sub',
1 `config.guess', Cygnus `configure', Automake and Libtool scripts,
1 etc.) that are in directory DIR. These are auxiliary files used
1 in configuration. DIR can be either absolute or relative to
1 `SRCDIR'. The default is `SRCDIR' or `SRCDIR/..' or
1 `SRCDIR/../..', whichever is the first that contains `install-sh'.
1 The other files are not checked for, so that using
1 `AC_PROG_INSTALL' does not automatically require distributing the
1 other auxiliary files. It checks for `install.sh' also, but that
1 name is obsolete because some `make' have a rule that creates
1 `install' from it if there is no makefile.
1
1 The auxiliary directory is commonly named `build-aux'. If you
1 need portability to DOS variants, do not name the auxiliary
1 directory `aux'. ⇒File System Conventions.
1
1 -- Macro: AC_REQUIRE_AUX_FILE (FILE)
1 Declares that FILE is expected in the directory defined above. In
1 Autoconf proper, this macro does nothing: its sole purpose is to be
1 traced by third-party tools to produce a list of expected auxiliary
1 files. For instance it is called by macros like `AC_PROG_INSTALL'
DONTPRINTYET 1 (⇒Particular Programs) or `AC_CANONICAL_BUILD' (*note1DONTPRINTYET 1 (⇒Particular Programs) or `AC_CANONICAL_BUILD' (⇒
Canonicalizing) to register the auxiliary files they need.
1
1 Similarly, packages that use `aclocal' should declare where local
1 macros can be found using `AC_CONFIG_MACRO_DIR'.
1
1 -- Macro: AC_CONFIG_MACRO_DIR (DIR)
1 Specify DIR as the location of additional local Autoconf macros.
1 This macro is intended for use by future versions of commands like
1 `autoreconf' that trace macro calls. It should be called directly
1 from `configure.ac' so that tools that install macros for
1 `aclocal' can find the macros' declarations.
1
1 Note that if you use `aclocal' from Automake to generate
1 `aclocal.m4', you must also set `ACLOCAL_AMFLAGS = -I DIR' in your
1 top-level `Makefile.am'. Due to a limitation in the Autoconf
1 implementation of `autoreconf', these include directives currently
1 must be set on a single line in `Makefile.am', without any
1 backslash-newlines.
1