X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/d1cce1dd9209f5fde2b58f798bf8eea8cf82f99f..3e85237e5ff3de51f67e1a43ce4c1e0827b1bd37:/rsync.yo diff --git a/rsync.yo b/rsync.yo index 5360d43b..f65e53cf 100644 --- a/rsync.yo +++ b/rsync.yo @@ -734,6 +734,8 @@ dit(bf(--link-dest=DIR)) This option behaves like bf(--compare-dest) but also will create hard links from em(DIR) to the destination directory for unchanged files. Files with changed ownership or permissions will not be linked. +Like bf(--compare-dest) if DIR is a relative path, it is relative +to the destination directory. dit(bf(-z, --compress)) With this option, rsync compresses any data from the files that it sends to the destination machine. This @@ -871,8 +873,8 @@ skipped. If it is an include pattern then that filename is not skipped. If no matching include/exclude pattern is found then the filename is not skipped. -The filenames matched against the exclude/incldue patterns are -relative to the base directories so patterns should not +The filenames matched against the exclude/include patterns are +relative to the base directories, so patterns should not include the path elements to those base directories. The only way in which a pattern will match the absolute path of a file or directory is if the base path is the root directory. @@ -893,7 +895,8 @@ itemize( start of the filename, otherwise it is matched against the end of the filename. This is the equivalent of a leading ^ in regular expressions. - Thus "/foo" would match a file called "foo" at the base of the tree. + Thus "/foo" would match a file called "foo" at the base of the + transferred tree. On the other hand, "foo" would match any file called "foo" anywhere in the tree because the algorithm is applied recursively from top down; it behaves as if each path component gets a turn at being the @@ -910,11 +913,11 @@ itemize( it() if the pattern includes a double asterisk "**" then all wildcards in the pattern will match slashes, otherwise they will stop at slashes. - it() if the pattern contains a / (not counting a trailing /) then it - is matched against the full filename, including any leading - directory. If the pattern doesn't contain a / then it is matched - only against the final component of the filename. Again, remember - that the algorithm is applied recursively so "full filename" can + it() if the pattern contains a / (not counting a trailing /) or a "**" + then it is matched against the full filename, including any leading + directory. If the pattern doesn't contain a / or a "**", then it is + matched only against the final component of the filename. Again, + remember that the algorithm is applied recursively so "full filename" can actually be any portion of a path. it() if the pattern starts with "+ " (a plus followed by a space) @@ -929,8 +932,9 @@ itemize( include/exclude list is reset, removing all previously defined patterns. ) -The +/- rules are most useful in exclude lists, allowing you to have a -single exclude list that contains both include and exclude options. +The +/- rules are most useful in a list that was read from a file, allowing +you to have a single exclude list that contains both include and exclude +options. If you end an exclude list with --exclude '*', note that since the algorithm is applied recursively that unless you explicitly include