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.
 
     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
 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.
 
     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
 0.  `--remove-source-files`
 
     This tells rsync to remove from the sending side the files (meaning