14.5 The Types of Distributions

Automake generates rules to provide archives of the project for distributions in various formats. Their targets are:

dist-bzip2

Generate a bzip2 tar archive of the distribution. bzip2 archives are frequently smaller than gzipped archives. By default, this rule makes ‘bzip2’ use a compression option of ‘-9’. To make it use a different one, set the BZIP2 environment variable. For example, ‘make dist-bzip2 BZIP2=-7’.

dist-gzip

Generate a gzip tar archive of the distribution.

dist-lzip

Generate a ‘lzip’ tar archive of the distribution. lzip archives are frequently smaller than bzip2-compressed archives.

dist-lzma

Generate an ‘lzma’ tar archive of the distribution. The ‘lzma’ format is obsolete, you should use the ‘xz’ format instead. Support for ‘lzma’-compressed archives will be removed in the next major Automake release.

dist-shar

Generate a shar archive of the distribution.

dist-xz

Generate an ‘xz’ tar archive of the distribution. xz archives are frequently smaller than bzip2-compressed archives. The ‘xz’ format displaces the obsolete ‘lzma’ format. By default, this rule makes ‘xz’ use a compression option of ‘-e’. To make it use a different one, set the XZ_OPT environment variable. For example, run this command to use the default compression ratio, but with a progress indicator: ‘make dist-xz XZ_OPT=-7e’.

dist-zip

Generate a zip archive of the distribution.

dist-tarZ

Generate a compressed tar archive of the distribution.

The rule dist (and its historical synonym dist-all) will create archives in all the enabled formats, Changing Automake’s Behavior. By default, only the dist-gzip target is hooked to dist.

This document was generated on February 3, 2012 using texi2html 5.0.