From: Wayne Davison <wayned@samba.org>
Date: Sun, 5 Apr 2020 16:43:59 +0000 (-0700)
Subject: Make the --copy-links caveat a little clearer.
X-Git-Tag: v3.2.0pre1~195
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3bd4e1e8cd868840f29ae5eda2e1c604a72acbdf;p=thirdparty%2Frsync.git

Make the --copy-links caveat a little clearer.
---

diff --git a/rsync.yo b/rsync.yo
index 1950349c..fdaf3d27 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -940,10 +940,11 @@ 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.
+"/src/subdir" to "/dest/" then the "subdir" directory is a name inside the
+transfer tree, not the top of the transfer (which is /src) so it is legal for
+created relative symlinks to refer to other names inside the /src and /dest
+directories. If you instead copy "/src/subdir/" (with a trailing slash) to
+"/dest/subdir" that would not allow symlinks to any files outside of "subdir".
 
 dit(bf(--safe-links)) This tells rsync to ignore any symbolic links
 which point outside the copied tree. All absolute symlinks are