Various file comparison improvements

[rsync.git] / rsync.1.md

diff --git a/rsync.1.md b/rsync.1.md
index 7bb4c5a1b4dc44abba3173bbb685ae6c8c60429f..d205d0ba56319f22eb7b233a1c522b2474f507d0 100644 (file)
--- a/rsync.1.md
+++ b/rsync.1.md
@@ -651,6 +651,10 @@ your home directory (remove the '=' for that).
     the same modification timestamp.  This option turns off this "quick check"
     behavior, causing all files to be updated.
 
+    This option can be a little confusing compared to `--ignore-existing` and
+    `--ignore-non-existing` in that that they cause rsync to transfer fewer
+    files, while this option causes rsync to transfer more files.
+
 0.  `--size-only`
 
     This modifies rsync's "quick check" algorithm for finding files that need
@@ -1602,6 +1606,15 @@ your home directory (remove the '=' for that).
     permissions on the hard-linked files).  This does mean that this option is
     only looking at the existing files in the destination hierarchy itself.
 
+    If `--info=skip` was specified (which is implied by `-vv`) then rsync
+    outputs a "FILENAME exists (INFO)" message where the INFO indicates one of
+    "uptodate", "type differs", or "differs".  However, if you specified the
+    `--checksum` option, you must have specified `--info-skip2` to get the
+    "differs" or "uptodate" info since rsync will not take the extra time to
+    checksum these skipped files unless you really want it to (a parenthetical
+    suffix that is not "type differs" is elided if we are skipping the checksum
+    check for an existing file).
+
 0.  `--remove-source-files`
 
     This tells rsync to remove from the sending side the files (meaning