diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2011-10-18 13:07:10 -0700 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2011-10-18 13:07:29 -0700 |
commit | 1e1fc0336bea2f273b8c6fdb376735ce13887899 (patch) | |
tree | 643036f475a35418648b8f9a0dae692ee3d220e2 | |
parent | 02533d1a602fd1441836bc7df12a3a0a96c806de (diff) | |
download | tar-1e1fc0336bea2f273b8c6fdb376735ce13887899.tar.gz |
* doc/tar.texi (Option Summary, absolute): Document -P better,
by describing how it deals with symbolic links on extraction.
-rw-r--r-- | doc/tar.texi | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/tar.texi b/doc/tar.texi index 8015b2b4..cf305926 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -2358,8 +2358,9 @@ exist in the archive. @xref{update}. @itemx -P Normally when creating an archive, @command{tar} strips an initial -@samp{/} from member names. This option disables that behavior. -@xref{absolute}. +@samp{/} from member names, and when extracting from an archive @command{tar} +treats names specially if they have initial @samp{/} or internal +@samp{..}. This option disables that behavior. @xref{absolute}. @opsummary{after-date} @item --after-date @@ -8531,6 +8532,10 @@ is not, generally speaking, the same as the one you'd get running scripts for comparing both outputs. @xref{listing member and file names}, for the information on how to handle this case.}. +Symbolic links containing @file{..} or leading @samp{/} can also cause +problems when extracting, so @command{tar} normally extracts them last; +it may create empty files as placeholders during extraction. + If you use the @option{--absolute-names} (@option{-P}) option, @command{tar} will do none of these transformations. @@ -8554,7 +8559,7 @@ to transfer files between systems.} @table @option @item --absolute-names Preserves full file names (including superior directory names) when -archiving files. Preserves leading slash when extracting files. +archiving and extracting files. @end table |