docs: TAR envvar overrides "tar" for make dist.

This change finishes https://bugs.gnu.org/9822.

* doc/automake.texi (Basics of Distribution): mention that
environment variable TAR overrides "tar".

diff --git a/doc/automake.texi b/doc/automake.texi
index 7cc7bcbca0fe8cd67cb14a32b4e9f3604d3edb7b..332cac15304459052508efe083fcb36beaf8281a 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8422,10 +8422,16 @@ for how these variables get their values, from either defaults or explicit
 values -- it's slightly trickier than one would expect).
 More precisely the gzipped @code{tar} file is named
 @samp{$@{PACKAGE@}-$@{VERSION@}.tar.gz}.
+
 @vindex GZIP_ENV
 You can use the @command{make} variable @code{GZIP_ENV} to control how gzip
 is run.  The default setting is @option{--best}.
 
+@c See automake #9822.
+@vindex TAR
+You can set the environment variable @code{TAR} to override the tar
+program used; it defaults to @code{tar}.
+
 @cindex @code{m4_include}, distribution
 @cindex @code{include}, distribution
 @acindex m4_include