From 4eb1484dced64b74cafda40918c0d96e5084846a Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 17 Mar 2015 10:46:20 -0700 Subject: [PATCH] tar: don't suggest GZIP * doc/tar.texi (gzip): Don't suggest using the GZIP environment variable, as it will be deprecated in the next gzip release. --- doc/tar.texi | 32 +++++++++++++------------------- 1 file changed, 13 insertions(+), 19 deletions(-) diff --git a/doc/tar.texi b/doc/tar.texi index 119ae16..9cff066 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -974,7 +974,7 @@ archive), numeric @acronym{ID} values are printed instead. @item File name. If the name contains any special characters (white space, newlines, -etc.) these are displayed in an unambiguous form using so called +etc.)@: these are displayed in an unambiguous form using so called @dfn{quoting style}. For the detailed discussion of available styles and on how to use them, see @ref{quoting styles}. @@ -3115,7 +3115,7 @@ Tells @command{tar} to create a new directory beneath the extraction directory tarbombs. In the absence of @var{dir} argument, the name of the new directory will be equal to the base name of the archive (file name minus the archive suffix, if recognized). Any member names that do not begin -with that directory name (after +with that directory name (after transformations from @option{--transform} and @option{--strip-components}) will be prefixed with it. Recognized file name suffixes are @samp{.tar}, and any compression suffixes @@ -5685,7 +5685,7 @@ contain command line arguments (see @ref{external, Running External Commands}, for more detail). Notice, that @var{command} is executed once for each regular file -extracted. Non-regular files (directories, etc.) are ignored when this +extracted. Non-regular files (directories, etc.)@: are ignored when this option is used. @end table @@ -7413,7 +7413,7 @@ However, empty lines are OK. @cindex Git, ignore files @cindex Bazaar, ignore files @cindex Mercurial, ignore files -When archiving directories that are under some version control system (VCS), +When archiving directories that are under some version control system (VCS), it is often convenient to read exclusion patterns from this VCS' ignore files (e.g. @file{.cvsignore}, @file{.gitignore}, etc.) The following options provide such possibilty: @@ -8970,7 +8970,7 @@ recent, so not all tar implementations are able to handle it properly. However, this format is designed in such a way that any tar implementation able to read @samp{ustar} archives will be able to read most @samp{posix} archives as well, with the only exception that any -additional information (such as long file names etc.) will in such +additional information (such as long file names etc.)@: will in such case be extracted as plain text files along with the files it refers to. This archive format will be the default format for future versions @@ -9179,18 +9179,11 @@ The output produced by @command{tar --help} shows the actual compressor names along with each of these options. You can use any of these options on physical devices (tape drives, -etc.) and remote files as well as on normal files; data to or from +etc.)@: and remote files as well as on normal files; data to or from such devices or remote files is reblocked by another copy of the @command{tar} program to enforce the specified (or default) record -size. The default compression parameters are used. Most compression -programs let you override these by setting a program-specific -environment variable. For example, with @command{gzip} you can set -@env{GZIP}: - -@smallexample -$ @kbd{GZIP='-9 -n' tar czf archive.tar.gz subdir} -@end smallexample -Another way would be to use the @option{-I} option instead (see +size. The default compression parameters are used. +You can override them by using the @option{-I} option (see below), e.g.: @smallexample @@ -9198,7 +9191,7 @@ $ @kbd{tar -cf archive.tar.gz -I 'gzip -9 -n' subdir} @end smallexample @noindent -Finally, the third, traditional, way to do this is to use a pipe: +A more traditional way to do this is to use a pipe: @smallexample $ @kbd{tar cf - subdir | gzip -9 -n > archive.tar.gz} @@ -9246,12 +9239,13 @@ suffix. The following suffixes are recognized: @item --use-compress-program=@var{command} @itemx -I=@var{command} Use external compression program @var{command}. Use this option if you +want to specify options for the compression program, or if you are not happy with the compression program associated with the suffix -at compile time or if you have a compression program that @GNUTAR{} +at compile time, or if you have a compression program that @GNUTAR{} does not support. The @var{command} argument is a valid command invocation, as you would type it at the command line prompt, with any additional options as needed. Enclose it in quotes if it contains -white space (see @ref{external, Running External Commands}, for more detail). +white space (@pxref{external, Running External Commands}). The @var{command} should follow two conventions: @@ -10780,7 +10774,7 @@ installed by default. @cindex absolute file names Unless you use the @option{--absolute-names} (@option{-P}) option, @GNUTAR{} will not allow you to create an archive that contains -absolute file names (a file name beginning with @samp{/}.) If you try, +absolute file names (a file name beginning with @samp{/}). If you try, @command{tar} will automatically remove the leading @samp{/} from the file names it stores in the archive. It will also type a warning message telling you what it is doing. -- 2.45.2