From 7a1b6cfa67ea6383cb94632dc46823a6f51605e0 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 21 Sep 2001 22:19:09 +0000 Subject: [PATCH] (extracting files): Mention --to-stdout. (Option Summary, Dealing with Old Files): New option --overwrite-dir. (Overwrite Old Files): Likewise. --- doc/tar.texi | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/tar.texi b/doc/tar.texi index 9c111a0..1cc52a2 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -1864,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. @@ -2799,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 @@ -4171,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} @@ -4217,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 -- 2.44.0