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