|[ < ]||[ > ]||[ << ]||[ Up ]||[ >> ]||[Top]||[Contents]||[Index]||[ ? ]|
The basic approach to creating a tar distribution is to run
make make dist
The generated tar file is named package-version.tar.gz, and will unpack into a directory named package-version. These two rules are mandated by the GNU Coding Standards, and are just good ideas in any case, because it is convenient for the end user to have the version information easily accessible while building a package. It removes any doubt when she goes back to an old tree after some time away from it. Unpacking into a fresh directory is always a good idea – in the old days some packages would unpack into the current directory, requiring an annoying clean-up job for the unwary system administrator.
The unpacked archive is completely portable, to the extent of Automake’s
ability to enforce this. That is, all the generated files (e.g.,
‘configure’) are newer than their inputs (e.g.,
‘configure.in’), and the distributed ‘Makefile.in’ files should
work with any version of
Of course, some of the responsibility for portability lies with you: you
are free to introduce non-portable code into your ‘Makefile.am’, and
Automake can’t diagnose this. No special tools beyond the minimal tool
list (see Minimal Tool List: (standards)Utilities in Makefiles section ‘Utilities in Makefiles’ in The GNU Coding Standards)
plus whatever your own ‘Makefile’ and ‘configure’ additions
use, will be required for the end user to build the package.
By default Automake creates a ‘.tar.gz’ file. It notices if you
are using GNU
tar and arranges to create portable archives in
People do sometimes want to make other sorts of distributions. Automake allows this through the use of options.
dist-bzip2 target, which creates a ‘.tar.bz2’ file.
These files are frequently smaller than the corresponding ‘.tar.gz’
dist-shar target, which creates a
dist-zip target, which creates a
These files are popular for Windows distributions.
dist-tarZ target, which creates a ‘.tar.Z’ file.
This exists mostly for die-hard old-time Unix hackers; the rest of the
world has moved on to
|[ < ]||[ > ]||[ << ]||[ Up ]||[ >> ]|
This document was generated by Ben Elliston on July 10, 2015 using texi2html 1.82.