(extracting files): Mention --to-stdout.

[chaz/tar] / doc / tar.texi

diff --git a/doc/tar.texi b/doc/tar.texi
index 2c9602433d3cd86011ca651b53ad9b06889d7c3e..1cc52a2df556f56f68c144b1ebdd3cfd6b0651be 100644 (file)
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -542,6 +542,7 @@ document.  The rest of the menu lists all the lower level nodes.
 * Date input formats::
 * Formats::
 * Media::
+* Free Software Needs Free Documentation::
 * Copying This Manual::
 * Index::
 
@@ -1863,6 +1864,10 @@ specify @w{@kbd{tar --extract --file=bfiles.tar ./birds}}.  To find the
 exact member names of the members of an archive, use @value{op-list}
 (@pxref{list}).
 
+You can extract a file to standard output by combining the above options
+with the @option{--to-stdout} option (@pxref{Writing to Standard
+Output}).
+
 If you give the @value{op-verbose} option, then @value{op-extract} will
 print the names of the archive members as it extracts them.
 
@@ -2798,6 +2803,11 @@ directory.  @FIXME-xref{}
 Overwrite existing files and directory metadata when extracting files
 from an archive.  @xref{Overwrite Old Files}.
 
+@item --overwrite-dir
+
+Overwrite the metadata of existing directories when extracting files
+from an archive.  @xref{Overwrite Old Files}.
+
 @item --owner=@var{user}
 
 Specifies that @command{tar} should use @var{user} as the owner of members
@@ -4170,6 +4180,9 @@ member.  Instead, it reports an error.
 To be more aggressive about altering existing files, use the
 @value{op-overwrite} option.  It causes @command{tar} to overwrite
 existing files and to follow existing symbolic links when extracting.
+The @option{--overwrite-dir} option is somewhat more conservative than
+@value{op-overwrite}: it overwrites metadata (ownership, permission,
+etc.) for directories, but removes other files before extracting them.
 
 Some people argue that @sc{gnu} @command{tar} should not hesitate to overwrite
 files with other files when extracting.  When extracting a @command{tar}
@@ -4216,6 +4229,10 @@ combined with the @value{op-absolute-names} option, as this combination
 can change the contents, ownership or permissions of any file on your
 system.  Also, many systems do not take kindly to overwriting files that
 are currently being executed.
+
+@item --overwrite-dir
+Overwrite the metadata of directories when extracting files from an
+archive, but remove other files before extracting.
 @end table
 
 @node Keep Old Files
@@ -6814,7 +6831,7 @@ does not distinguish text files from binary files, and no translation
 of file contents is performed.
 
 The @code{name}, @code{linkname}, @code{magic}, @code{uname}, and
-@code{gname} are null-terminated character strings.  All other fileds
+@code{gname} are null-terminated character strings.  All other fields
 are zero-filled octal numbers in ASCII.  Each numeric field of width
 @var{w} contains @var{w} minus 2 digits, a space, and a null, except
 @code{size}, and @code{mtime}, which do not contain the trailing null.
@@ -8421,6 +8438,10 @@ disabled) switch, a notch which can be popped out or covered, a ring
 which can be removed from the center of a tape reel, or some other
 changeable feature.
 
+@node Free Software Needs Free Documentation
+@appendix Free Software Needs Free Documentation
+@include freemanuals.texi
+
 @node Copying This Manual
 @appendix Copying This Manual