1.13.25

[chaz/tar] / doc / tar.texi

diff --git a/doc/tar.texi b/doc/tar.texi
index 2c9602433d3cd86011ca651b53ad9b06889d7c3e..a3e9286ed59ea9d8f4e4ca116183d73f404aaa74 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::
 * Date input formats::
 * Formats::
 * Media::

+* Free Software Needs Free Documentation::

 * Copying This Manual::
 * Index::
 
 * 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}).
 
 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.
 
 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}.
 
 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
 @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.
 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}
 
 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.
 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
 @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
 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.
 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.


@@ -7352,7 +7369,7 @@ from the archive, or you should either use the @value{op-absolute-names}
 option, or use the command @samp{tar -C / @dots{}}.
 
 @cindex Ultrix 3.1 and write failure
 option, or use the command @samp{tar -C / @dots{}}.
 
 @cindex Ultrix 3.1 and write failure

-Some versions of Unix (Ultrix 3.1 is know to have this problem),
+Some versions of Unix (Ultrix 3.1 is known to have this problem),

 can claim that a short write near the end of a tape succeeded,
 when it actually failed.  This will result in the -M option not
 working correctly.  The best workaround at the moment is to use a
 can claim that a short write near the end of a tape succeeded,
 when it actually failed.  This will result in the -M option not
 working correctly.  The best workaround at the moment is to use a


@@ -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.
 
 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
 
 @node Copying This Manual
 @appendix Copying This Manual