X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/c5b6e57a136d5bdc1eff9ef11e69c7093065920e..ab3d6c6025162c19c082602aa1e488f22e40d392:/rsync.yo

diff --git a/rsync.yo b/rsync.yo
index 60e1c178..d5f6eadc 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -1346,6 +1346,12 @@ 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.
 
+This option works best when copying into an empty destination hierarchy, as
+rsync treats existing files as definitive (so it never looks in the link-dest
+dirs when a destination file already exists), and as malleable (so it might
+change the attributes of a destination file, which affects all the hard-linked
+versions).
+
 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