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.
This commit is contained in:
Paul Eggert
2015-03-17 10:46:20 -07:00
parent 1847ec67ce
commit 4eb1484dce

View File

@@ -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.