(Operation Summary): Restore alphabetical order of the options.

This commit is contained in:
Sergey Poznyakoff
2007-06-08 08:27:32 +00:00
parent 6287d3045f
commit c8d4ceccc1

View File

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