Update the docs.

* doc/tar.texi: Parsing of the options found in the file list
follows the same rules as for command line.  Remove the obsolete
description.  This complements 26538c9b.
This commit is contained in:
Sergey Poznyakoff
2013-08-04 19:39:42 +03:00
parent 47560a0498
commit ddff3e9038

View File

@@ -7120,45 +7120,6 @@ libc.a
@end group
@end smallexample
@noindent
@xopindex{directory, using in @option{--files-from} argument}
Notice that the option parsing algorithm used with @option{-T} is
stricter than the one used by shell. Namely, when specifying option
arguments, you should observe the following rules:
@itemize @bullet
@item
When using short (single-letter) option form, its argument must
immediately follow the option letter, without any intervening
whitespace. For example: @code{-Cdir}.
@item
When using long option form, the option argument must be separated
from the option by a single equal sign. No whitespace is allowed on
any side of the equal sign. For example: @code{--directory=dir}.
@item
For both short and long option forms, the option argument can be given
on the next line after the option name, e.g.:
@smallexample
@group
--directory
dir
@end group
@end smallexample
@noindent
and
@smallexample
@group
-C
dir
@end group
@end smallexample
@end itemize
@opindex add-file
If you happen to have a file whose name starts with @samp{-},
precede it with @option{--add-file} option to prevent it from
@@ -7226,10 +7187,11 @@ $ @kbd{find . -size +800 -print0 |
This example uses short options for typographic reasons, to avoid
very long lines.
@GNUTAR is able to automatically detect @code{NUL}-terminated file lists, so
it is safe to use them even without the @option{--null} option. In
this case @command{tar} will print a warning and continue reading such
a file as if @option{--null} were actually given:
@GNUTAR is tries to automatically detect @code{NUL}-terminated file
lists, so in many cases it is safe to use them even without the
@option{--null} option. In this case @command{tar} will print a
warning and continue reading such a file as if @option{--null} were
actually given:
@smallexample
@group