From 32a5edf43f92422d4414b5a519c271ba00623248 Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Sat, 12 Feb 2005 22:21:45 +0000 Subject: [PATCH] Improved the documentation of the --compress (-z) option. --- rsync.yo | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/rsync.yo b/rsync.yo index 0770d2f2..77d906e0 100644 --- a/rsync.yo +++ b/rsync.yo @@ -354,7 +354,7 @@ to the detailed description below for a complete description. verb( --compare-dest=DIR also compare received files relative to DIR --copy-dest=DIR ... and include copies of unchanged files --link-dest=DIR hardlink to files in DIR when unchanged - -z, --compress compress file data + -z, --compress compress file data during the transfer -C, --cvs-exclude auto-ignore files in the same way CVS does -f, --filter=RULE add a file-filtering RULE -F same as --filter=': /.rsync-filter' @@ -956,15 +956,14 @@ bf(--link-dest) from working properly for a non-root user when bf(-o) was specif (or implied by bf(-a)). You can work-around this bug by avoiding the bf(-o) option when sending to an old rsync. -dit(bf(-z, --compress)) With this option, rsync compresses any data from -the files that it sends to the destination machine. This -option is useful on slow connections. The compression method used is the -same method that gzip uses. +dit(bf(-z, --compress)) With this option, rsync compresses the file data +as it is sent to the destination machine, which reduces the amount of data +being transmitted -- something that is useful over a slow connection. -Note this this option typically achieves better compression ratios -that can be achieved by using a compressing remote shell, or a -compressing transport, as it takes advantage of the implicit -information sent for matching data blocks. +Note this this option typically achieves better compression ratios that can +be achieved by using a compressing remote shell or a compressing transport +because it takes advantage of the implicit information in the matching data +blocks that are not explicitly sent over the connection. dit(bf(--numeric-ids)) With this option rsync will transfer numeric group and user IDs rather than using user and group names and mapping them -- 2.34.1