docs: improve documentation of 'dist-*' targets slightly

* doc/automake.texi (The Types of Distributions): Here.

Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>

diff --git a/doc/automake.texi b/doc/automake.texi
index 76761a7..8d8c2c9 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8663,8 +8663,8 @@ only format enabled by default.
 
 @vindex BZIP2
 @item @code{dist-bzip2}
-Generate a bzip2 tar archive of the distribution.  bzip2 archives are
-frequently smaller than gzipped archives.
+Generate a @samp{bzip2} tar archive of the distribution.  bzip2 archives
+are frequently smaller than gzipped archives.
 By default, this rule makes @samp{bzip2} use a compression option of @option{-9}.
 To make it use a different one, set the @env{BZIP2} environment variable.
 For example, @samp{make dist-bzip2 BZIP2=-7}.
@@ -8676,7 +8676,7 @@ archives are frequently smaller than @command{bzip2}-compressed archives.
 @trindex dist-lzip
 
 @item @code{dist-shar}
-Generate a shar archive of the distribution.
+Generate a @samp{shar} archive of the distribution.
 @trindex dist-shar
 
 @vindex XZ_OPT
@@ -8691,12 +8691,12 @@ default compression ratio, but with a progress indicator:
 @trindex dist-xz
 
 @item @code{dist-zip}
-Generate a zip archive of the distribution.
+Generate a @samp{zip} archive of the distribution.
 @trindex dist-zip
 
 @item @code{dist-tarZ}
-Generate a compressed tar archive of
-the distribution.
+Generate a tar archive of the distribution, compressed with the
+historical program @command{compress}.
 @trindex dist-tarZ
 @end table