From: Wayne Davison <wayned@samba.org>
Date: Sat, 30 Sep 2006 15:21:25 +0000 (+0000)
Subject: Document that --ignore-times thwarts all --link-dest linking.
X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/commitdiff_plain/d04e95e96831cac3cac33b7227a729d2b5afb485

Document that --ignore-times thwarts all --link-dest linking.
---

diff --git a/rsync.yo b/rsync.yo
index bfff5043..5e540ea1 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -461,7 +461,8 @@ cron.
 
 dit(bf(-I, --ignore-times)) Normally rsync will skip any files that are
 already the same size and have the same modification time-stamp.
-This option turns off this "quick check" behavior.
+This option turns off this "quick check" behavior, causing all files to
+be updated.
 
 dit(bf(--size-only)) Normally rsync will not transfer any files that are
 already the same size and have the same modification time-stamp. With the
@@ -1302,6 +1303,11 @@ and the attributes updated.
 If a match is not found, a basis file from one of the em(DIR)s will be
 selected to try to speed up the transfer.
 
+Note that if you combine this option with bf(--ignore-times), rsync will not
+link any files together because it only links identical files together as a
+substitute for transferring the file, never as an additional check after the
+file is updated.
+
 If em(DIR) is a relative path, it is relative to the destination directory.
 See also bf(--compare-dest) and bf(--copy-dest).