[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
6.4.1 Public Macros
-
AM_ENABLE_MULTILIB
-
This is used when a “multilib” library is being built. The first optional argument is the name of the ‘Makefile’ being generated; it defaults to ‘Makefile’. The second optional argument is used to find the top source directory; it defaults to the empty string (generally this should not be used unless you are familiar with the internals). See section Support for Multilibs.
-
AM_INIT_AUTOMAKE([OPTIONS])
-
AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE])
-
Runs many macros required for proper operation of the generated Makefiles.
This macro has two forms, the first of which is preferred. In this form,
AM_INIT_AUTOMAKE
is called with a single argument: a space-separated list of Automake options that should be applied to every ‘Makefile.am’ in the tree. The effect is as if each option were listed inAUTOMAKE_OPTIONS
(see section Changing Automake's Behavior).The second, deprecated, form of
AM_INIT_AUTOMAKE
has two required arguments: the package and the version number. This form is obsolete because the package and version can be obtained from Autoconf'sAC_INIT
macro (which itself has an old and a new form).If your ‘configure.ac’ has:
AC_INIT([src/foo.c]) AM_INIT_AUTOMAKE([mumble], [1.5])
you can modernize it as follows:
AC_INIT([mumble], [1.5]) AC_CONFIG_SRCDIR([src/foo.c]) AM_INIT_AUTOMAKE
Note that if you're upgrading your ‘configure.ac’ from an earlier version of Automake, it is not always correct to simply move the package and version arguments from
AM_INIT_AUTOMAKE
directly toAC_INIT
, as in the example above. The first argument toAC_INIT
should be the name of your package (e.g., ‘GNU Automake’), not the tarball name (e.g., ‘automake’) that you used to pass toAM_INIT_AUTOMAKE
. Autoconf tries to derive a tarball name from the package name, which should work for most but not all package names. (If it doesn't work for yours, you can use the four-argument form ofAC_INIT
to provide the tarball name explicitly).By default this macro
AC_DEFINE
'sPACKAGE
andVERSION
. This can be avoided by passing the ‘no-define’ option, as in:AM_INIT_AUTOMAKE([gnits 1.5 no-define dist-bzip2])
or by passing a third non-empty argument to the obsolete form.
-
AM_PATH_LISPDIR
-
Searches for the program
emacs
, and, if found, sets the output variablelispdir
to the full path to Emacs' site-lisp directory.Note that this test assumes the
emacs
found to be a version that supports Emacs Lisp (such as GNU Emacs or XEmacs). Other emacsen can cause this test to hang (some, like old versions of MicroEmacs, start up in interactive mode, requiring C-x C-c to exit, which is hardly obvious for a non-emacs user). In most cases, however, you should be able to use C-c to kill the test. In order to avoid problems, you can setEMACS
to “no” in the environment, or use the ‘--with-lispdir’ option toconfigure
to explicitly set the correct path (if you're sure you have anemacs
that supports Emacs Lisp). -
AM_PROG_AS
-
Use this macro when you have assembly code in your project. This will choose the assembler for you (by default the C compiler) and set
CCAS
, and will also setCCASFLAGS
if required. -
AM_PROG_CC_C_O
-
This is like
AC_PROG_CC_C_O
, but it generates its results in the manner required by Automake. You must use this instead ofAC_PROG_CC_C_O
when you need this functionality, that is, when using per-target flags or subdir-objects with C sources. -
AM_PROG_LEX
-
Like
AC_PROG_LEX
(see (autoconf)Particular Programs section `Particular Program Checks' in The Autoconf Manual), but uses themissing
script on systems that do not havelex
. HP-UX 10 is one such system. -
AM_PROG_GCJ
-
This macro finds the
gcj
program or causes an error. It setsGCJ
andGCJFLAGS
.gcj
is the Java front-end to the GNU Compiler Collection. -
AM_PROG_UPC([compiler-search-list])
-
Find a compiler for Unified Parallel C and define the
UPC
variable. The default compiler-search-list is ‘upcc upc’. This macro will abortconfigure
if no Unified Parallel C compiler is found. -
AM_SILENT_RULES
-
Enable the machinery for less verbose build output (see section Changing Automake's Behavior).
-
AM_WITH_DMALLOC
-
Add support for the Dmalloc package. If the user runs
configure
with ‘--with-dmalloc’, then defineWITH_DMALLOC
and add ‘-ldmalloc’ toLIBS
. -
AM_WITH_REGEX
-
Adds ‘--with-regex’ to the
configure
command line. If specified (the default), then the ‘regex’ regular expression library is used, ‘regex.o’ is put intoLIBOBJS
, andWITH_REGEX
is defined. If ‘--without-regex’ is given, then therx
regular expression library is used, and ‘rx.o’ is put intoLIBOBJS
.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |