Added the ability to prefix "no-" to various options, which gives the

[rsync/rsync.git] / rsync.yo

diff --git a/rsync.yo b/rsync.yo
index 9d2413e..12bd07d 100644 (file)
--- a/rsync.yo
+++ b/rsync.yo
@@ -502,9 +502,12 @@ dot dir must followed by a slash, so "/foo/." would not be abbreviated.)
 (2) For older rsync versions, you would need to use a chdir to limit the
 source path.  For example, when pushing files:
 
-quote(tt(   cd /foo; rsync -avR bar/baz.c remote:/tmp/))
+quote(tt(   (cd /foo; rsync -avR bar/baz.c remote:/tmp/) ))
 
-Or when pulling files (which doesn't work with an rsync daemon):
+(Note that the parens put the two commands into a sub-shell, so that the
+"cd" command doesn't remain in effect for future commands.)
+If you're pulling files, use this idiom (which doesn't work with an
+rsync daemon):
 
 quote(
 tt(   rsync -avR --rsync-path="cd /foo; rsync" \ )nl()
@@ -584,9 +587,10 @@ dit(bf(--append)) This causes rsync to update a file by appending data onto
 the end of the file, which presumes that the data that already exists on
 the receiving side is identical with the start of the file on the sending
 side.  If that is not true, the file will fail the checksum test, and the
-resend will do a normal bf(--inplace) update to correct the mismatch.  Any
-file on the receiving side that is longer than a file on the sending side
-is skipped.  Implies bf(--inplace).
+resend will do a normal bf(--inplace) update to correct the mismatched data.
+Only files on the receiving side that are shorter than the corresponding
+file on the sending side (as well as new files) are sent.
+Implies bf(--inplace).
 
 dit(bf(-d, --dirs)) Tell the sending side to include any directories that
 are encountered.  Unlike bf(--recursive), a directory's contents are not copied