(Operation Summary): Restore alphabetical order of the options.
This commit is contained in:
84
doc/tar.texi
84
doc/tar.texi
@@ -2740,15 +2740,6 @@ multi-volume @command{tar} archive. @xref{Using Multiple Tapes}.
|
|||||||
|
|
||||||
(see --info-script)
|
(see --info-script)
|
||||||
|
|
||||||
@opsummary{seek}
|
|
||||||
@item --seek
|
|
||||||
@itemx -n
|
|
||||||
|
|
||||||
Assume that the archive media supports seeks to arbitrary
|
|
||||||
locations. Usually @command{tar} determines automatically whether
|
|
||||||
the archive can be seeked or not. This option is intended for use
|
|
||||||
in cases when such recognition fails.
|
|
||||||
|
|
||||||
@opsummary{newer}
|
@opsummary{newer}
|
||||||
@item --newer=@var{date}
|
@item --newer=@var{date}
|
||||||
@itemx --after-date=@var{date}
|
@itemx --after-date=@var{date}
|
||||||
@@ -2920,39 +2911,6 @@ this interpretation fails, it has to be a decimal numeric user @acronym{ID}.
|
|||||||
|
|
||||||
This option does not affect extraction from archives.
|
This option does not affect extraction from archives.
|
||||||
|
|
||||||
@opsummary{transform}
|
|
||||||
@item --transform=@var{sed-expr}
|
|
||||||
|
|
||||||
Transform file or member names using @command{sed} replacement expression
|
|
||||||
@var{sed-expr}. For example,
|
|
||||||
|
|
||||||
@smallexample
|
|
||||||
$ @kbd{tar cf archive.tar --transform 's,^\./,usr/,' .}
|
|
||||||
@end smallexample
|
|
||||||
|
|
||||||
@noindent
|
|
||||||
will add to @file{archive} files from the current working directory,
|
|
||||||
replacing initial @samp{./} prefix with @samp{usr/}. For the detailed
|
|
||||||
discussion, @xref{transform}.
|
|
||||||
|
|
||||||
To see transformed member names in verbose listings, use
|
|
||||||
@option{--show-transformed-names} option
|
|
||||||
(@pxref{show-transformed-names}).
|
|
||||||
|
|
||||||
@opsummary{quote-chars}
|
|
||||||
@item --quote-chars=@var{string}
|
|
||||||
Always quote characters from @var{string}, even if the selected
|
|
||||||
quoting style would not quote them (@pxref{quoting styles}).
|
|
||||||
|
|
||||||
@opsummary{quoting-style}
|
|
||||||
@item --quoting-style=@var{style}
|
|
||||||
Set quoting style to use when printing member and file names
|
|
||||||
(@pxref{quoting styles}). Valid @var{style} values are:
|
|
||||||
@code{literal}, @code{shell}, @code{shell-always}, @code{c},
|
|
||||||
@code{escape}, @code{locale}, and @code{clocale}. Default quoting
|
|
||||||
style is @code{escape}, unless overridden while configuring the
|
|
||||||
package.
|
|
||||||
|
|
||||||
@opsummary{pax-option}
|
@opsummary{pax-option}
|
||||||
@item --pax-option=@var{keyword-list}
|
@item --pax-option=@var{keyword-list}
|
||||||
This option is meaningful only with @acronym{POSIX.1-2001} archives
|
This option is meaningful only with @acronym{POSIX.1-2001} archives
|
||||||
@@ -2993,6 +2951,20 @@ that number as the permissions to create the destination file.
|
|||||||
Specifying this option instructs @command{tar} that it should use the
|
Specifying this option instructs @command{tar} that it should use the
|
||||||
permissions directly from the archive. @xref{Setting Access Permissions}.
|
permissions directly from the archive. @xref{Setting Access Permissions}.
|
||||||
|
|
||||||
|
@opsummary{quote-chars}
|
||||||
|
@item --quote-chars=@var{string}
|
||||||
|
Always quote characters from @var{string}, even if the selected
|
||||||
|
quoting style would not quote them (@pxref{quoting styles}).
|
||||||
|
|
||||||
|
@opsummary{quoting-style}
|
||||||
|
@item --quoting-style=@var{style}
|
||||||
|
Set quoting style to use when printing member and file names
|
||||||
|
(@pxref{quoting styles}). Valid @var{style} values are:
|
||||||
|
@code{literal}, @code{shell}, @code{shell-always}, @code{c},
|
||||||
|
@code{escape}, @code{locale}, and @code{clocale}. Default quoting
|
||||||
|
style is @code{escape}, unless overridden while configuring the
|
||||||
|
package.
|
||||||
|
|
||||||
@opsummary{read-full-records}
|
@opsummary{read-full-records}
|
||||||
@item --read-full-records
|
@item --read-full-records
|
||||||
@itemx -B
|
@itemx -B
|
||||||
@@ -3067,6 +3039,15 @@ effect only for ordinary users. @xref{Attributes}.
|
|||||||
|
|
||||||
(See @option{--preserve-permissions}; @pxref{Setting Access Permissions}.)
|
(See @option{--preserve-permissions}; @pxref{Setting Access Permissions}.)
|
||||||
|
|
||||||
|
@opsummary{seek}
|
||||||
|
@item --seek
|
||||||
|
@itemx -n
|
||||||
|
|
||||||
|
Assume that the archive media supports seeks to arbitrary
|
||||||
|
locations. Usually @command{tar} determines automatically whether
|
||||||
|
the archive can be seeked or not. This option is intended for use
|
||||||
|
in cases when such recognition fails.
|
||||||
|
|
||||||
@opsummary{show-defaults}
|
@opsummary{show-defaults}
|
||||||
@item --show-defaults
|
@item --show-defaults
|
||||||
|
|
||||||
@@ -3180,6 +3161,25 @@ Sets the data modification time of extracted files to the extraction time,
|
|||||||
rather than the data modification time stored in the archive.
|
rather than the data modification time stored in the archive.
|
||||||
@xref{Data Modification Times}.
|
@xref{Data Modification Times}.
|
||||||
|
|
||||||
|
@opsummary{transform}
|
||||||
|
@item --transform=@var{sed-expr}
|
||||||
|
|
||||||
|
Transform file or member names using @command{sed} replacement expression
|
||||||
|
@var{sed-expr}. For example,
|
||||||
|
|
||||||
|
@smallexample
|
||||||
|
$ @kbd{tar cf archive.tar --transform 's,^\./,usr/,' .}
|
||||||
|
@end smallexample
|
||||||
|
|
||||||
|
@noindent
|
||||||
|
will add to @file{archive} files from the current working directory,
|
||||||
|
replacing initial @samp{./} prefix with @samp{usr/}. For the detailed
|
||||||
|
discussion, @xref{transform}.
|
||||||
|
|
||||||
|
To see transformed member names in verbose listings, use
|
||||||
|
@option{--show-transformed-names} option
|
||||||
|
(@pxref{show-transformed-names}).
|
||||||
|
|
||||||
@opsummary{uncompress}
|
@opsummary{uncompress}
|
||||||
@item --uncompress
|
@item --uncompress
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user