diff --git a/doc/tar.1 b/doc/tar.1 index c4c990f9..ddf4fdcf 100644 --- a/doc/tar.1 +++ b/doc/tar.1 @@ -219,7 +219,10 @@ There is no short option equivalent for this option. \fB\-u\fR, \fB\-\-update\fR Append files which are newer than the corresponding copy in the archive. Arguments have the same meaning as with \fB\-c\fR and -\fB\-r\fR options. +\fB\-r\fR options. Notice, that newer files don't replace their +old archive copies, but instead are appended to the end of archive. +The resulting archive can thus contain several members of the +same name, corresponding to various versions of the same file. .TP \fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR Extract files from an archive. Arguments are optional. When given, diff --git a/doc/tar.texi b/doc/tar.texi index 572e3dd9..5d2d057a 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -5195,7 +5195,7 @@ the one at the end will be newer and larger, since you added text before updating it. The reason @command{tar} does not overwrite the older file when updating -it is because writing to the middle of a section of tape is a difficult +it is that writing to the middle of a section of tape is a difficult process. Tapes are not designed to go backward. @xref{Media}, for more information about tapes.