[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
14.1 Basics of Distribution
The dist
rule in the generated ‘Makefile.in’ can be used
to generate a gzipped tar
file and other flavors of archive for
distribution. The file is named based on the PACKAGE
and
VERSION
variables defined by AM_INIT_AUTOMAKE
(see section Autoconf macros supplied with Automake); more precisely the gzipped tar
file is named
‘package-version.tar.gz’.
You can use the make
variable GZIP_ENV
to control how gzip
is run. The default setting is ‘--best’.
For the most part, the files to distribute are automatically found by
Automake: all source files are automatically included in a distribution,
as are all ‘Makefile.am’s and ‘Makefile.in’s. Automake also
has a built-in list of commonly used files that are automatically
included if they are found in the current directory (either physically,
or as the target of a ‘Makefile.am’ rule). This list is printed by
‘automake --help’. Also, files that are read by configure
(i.e. the source files corresponding to the files specified in various
Autoconf macros such as AC_CONFIG_FILES
and siblings) are
automatically distributed. Files included in ‘Makefile.am’s (using
include
) or in ‘configure.ac’ (using m4_include
), and
helper scripts installed with ‘automake --add-missing’ are also
distributed.
Still, sometimes there are files that must be distributed, but which
are not covered in the automatic rules. These files should be listed in
the EXTRA_DIST
variable. You can mention files from
subdirectories in EXTRA_DIST
.
You can also mention a directory in EXTRA_DIST
; in this case the
entire directory will be recursively copied into the distribution.
Please note that this will also copy everything in the directory,
including CVS/RCS version control files. We recommend against using
this feature.
If you define SUBDIRS
, Automake will recursively include the
subdirectories in the distribution. If SUBDIRS
is defined
conditionally (see section Conditionals), Automake will normally include
all directories that could possibly appear in SUBDIRS
in the
distribution. If you need to specify the set of directories
conditionally, you can set the variable DIST_SUBDIRS
to the
exact list of subdirectories to include in the distribution
(see section Conditional Subdirectories).
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |