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:
32
doc/tar.texi
32
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.
|
||||
|
||||
Reference in New Issue
Block a user