From: Wayne Davison <wayned@samba.org>
Date: Sat, 16 Mar 2019 17:55:21 +0000 (-0700)
Subject: Clarify the cut-off point for --copy-safe-links.
X-Git-Tag: v3.2.0pre1~201
X-Git-Url: http://git.samba.org/samba.git/?p=rsync.git;a=commitdiff_plain;h=eb1b138ec2b363268acfef07e1face7c4e662409

Clarify the cut-off point for --copy-safe-links.
---

diff --git a/rsync.yo b/rsync.yo
index df876022..207d487e 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -939,6 +939,13 @@ are also treated like ordinary files, and so are any symlinks in the
 source path itself when bf(--relative) is used.  This option has no
 additional effect if bf(--copy-links) was also specified.
 
+Note that the cut-off point is the top of the transfer, which is the part of
+the path that rsync isn't mentioning in the verbose output.  If you copy
+"subdir" to "/dest/" then the subdir directory is a name inside the transfer
+tree, not the top of the transfer (its parent directory is the top) so it is
+legal for created relative symlinks to refer to other names inside the /dest
+dir.
+
 dit(bf(--safe-links)) This tells rsync to ignore any symbolic links
 which point outside the copied tree. All absolute symlinks are
 also ignored. Using this option in conjunction with bf(--relative) may