Minor improvements in the docs.

diff --git a/doc/tar.1 b/doc/tar.1
index c4c990f9543da28fb7679f3c53b196fcabe2205d..ddf4fdcf3f46c91de907da17d96a1a668af62b5e 100644 (file)
--- 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 572e3dd9e3d72fa65e5342af93f9ba23c8bedcd8..5d2d057ac1948ae75b29899d839bc3956ecdb862 100644 (file)
--- 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.