>From a8f36147417116ab0af6977b5688e2fd94f28600 Mon Sep 17 00:00:00 2001 Message-Id: In-Reply-To: References: From: Stefano Lattarini Date: Tue, 22 Jan 2013 12:30:15 +0100 Subject: [PATCH 4/5] docs: 'dist-shar' and 'dist-tarZ' are obsolescent today Both the options and the formats; and they might be deprecated and removed in future automake versions (see discussion on automake bug#13324). In any case, it's better if the documentation starts advising against their use right now. * doc/automake.texi (The Types of Distributions): Here. (List of Automake options): And here. Signed-off-by: Stefano Lattarini --- doc/automake.texi | 30 ++++++++++++++++++------------ 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/doc/automake.texi b/doc/automake.texi index 8d8c2c9..33caba4 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -8675,10 +8675,6 @@ Generate an @samp{lzip} tar archive of the distribution. @command{lzip} archives are frequently smaller than @command{bzip2}-compressed archives. @trindex dist-lzip address@hidden @code{dist-shar} -Generate a @samp{shar} archive of the distribution. address@hidden dist-shar - @vindex XZ_OPT @item @code{dist-xz} Generate an @samp{xz} tar archive of the distribution. @command{xz} @@ -8696,8 +8692,15 @@ Generate a @samp{zip} archive of the distribution. @item @code{dist-tarZ} Generate a tar archive of the distribution, compressed with the -historical program @command{compress}. +historical (obsolescent) program @command{compress}. Use of this +option is discouraged. @trindex dist-tarZ + address@hidden @code{dist-shar} +Generate a @samp{shar} archive of the distribution. This format archive +is obsolescent, and use of this option is discouraged. address@hidden dist-shar + @end table The rule @code{dist} (and its historical synonym @code{dist-all}) will @@ -10074,22 +10077,25 @@ Hook @code{dist-lzip} to @code{dist}. Hook @code{dist-xz} to @code{dist}. @trindex dist-xz address@hidden @option{dist-shar} address@hidden Option, @option{dist-shar} address@hidden dist-shar -Hook @code{dist-shar} to @code{dist}. address@hidden dist-shar - @item @option{dist-zip} @cindex Option, @option{dist-zip} @opindex dist-zip Hook @code{dist-zip} to @code{dist}. @trindex dist-zip address@hidden @option{dist-shar} address@hidden Option, @option{dist-shar} address@hidden dist-shar +Hook @code{dist-shar} to @code{dist}. Use of this option +is discouraged, as the @samp{shar} format is obsolescent and +problematic. address@hidden dist-shar + @item @option{dist-tarZ} @cindex Option, @option{dist-tarZ} @opindex dist-tarZ -Hook @code{dist-tarZ} to @code{dist}. +Hook @code{dist-tarZ} to @code{dist}. Use of this option +is discouraged, as the @samp{compress} program is obsolete. @trindex dist-tarZ @item @option{filename-length-max=99} -- 1.8.1.rc3.438.ge9abef6