In non-flat packages, the top level `Makefile.am' must tell
Automake which subdirectories are to be built. This is done via the
SUBDIRS
variable.
The SUBDIRS
macro holds a list of subdirectories in which
building of various sorts can occur. Many targets (eg all
) in
the generated `Makefile' will run both locally and in all specified
subdirectories. Note that the directories listed in SUBDIRS
are
not required to contain `Makefile.am's; only `Makefile's
(after configuration). This allows inclusion of libraries from packages
which do not use Automake (such as gettext
). The directories
mentioned in SUBDIRS
must be direct children of the current
directory. For instance, you cannot put `src/subdir' into
SUBDIRS
.
In a deep package, the top-level `Makefile.am' is often very short. For instance, here is the `Makefile.am' from the Hello distribution:
EXTRA_DIST = BUGS ChangeLog.O README-alpha SUBDIRS = doc intl po src tests
SUBDIRS
can contain configure substitutions (eg `@DIRS@');
Automake itself does not actually examine the contents of this variable.
If SUBDIRS
is defined, then your `configure.in' must include
AC_PROG_MAKE_SET
.
The use of SUBDIRS
is not restricted to just the top-level
`Makefile.am'. Automake can be used to construct packages of
arbitrary depth.
Go to the first, previous, next, last section, table of contents.