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

diff --git a/rsync.yo b/rsync.yo
index 1950349c128c99e18d3290d3f0facae4581baef9..fdaf3d278e16b142c422c29005973f03facec162 100644 (file)
--- 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