X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Ftar.texi;h=9bb5a833c8c4c0d09d6f8012c13c44ab52dfc1d4;hb=29a6964af3e1baabe978ce608e0466e1250d08ab;hp=48c22a36dc6eb0e2bb213528e239934c6316ef70;hpb=1689ed43885c8418c29d1365ae3a06450a460830;p=chaz%2Ftar diff --git a/doc/tar.texi b/doc/tar.texi index 48c22a3..9bb5a83 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -3319,6 +3319,27 @@ The @option{--warning=existing-file} option can be used together with this option to produce warning messages about existing old files (@pxref{warnings}). +@opsummary{sort} +@item --sort=@var{order} +Specify the directory sorting order when reading directories. +@var{Order} may be one of the following: + +@table @samp +@item none +No directory sorting is performed. This is the default. + +@item name +Sort the directory entries on name. The operating system may deliver +directory entries in a more or less random order, and sorting them +makes archive creation reproducible. + +@item inode +Sort the directory entries on inode number. Sorting directories on +inode number may reduce the amount of disk seek operations when +creating an archive for some file systems. + +@end table + @opsummary{sparse} @item --sparse @itemx -S @@ -3627,7 +3648,7 @@ successfully. For example, @w{@samp{tar --version}} might print: @smallexample tar (GNU tar) @value{VERSION} -Copyright (C) 2013 Free Software Foundation, Inc. +Copyright (C) 2013-2014 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. @@ -4030,7 +4051,7 @@ Pad output with spaces to the @var{n}th column. If the @samp{@{@var{n}@}} part is omitted, the current screen width is assumed. -@item %@var{c} +@item %c This is a shortcut for @samp{%@{%Y-%m-%d %H:%M:%S@}t: %ds, %@{read,wrote@}T%*\r}, intended mainly for use with @samp{ttyout} action (see below). @end table