X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/f2ebbebead082e942a16997e0cdcf6fba8066f50..064071011597ccab5486a2a459e425f15b4126cd:/rsync.yo

diff --git a/rsync.yo b/rsync.yo
index 96ce4bbb..6c1c8ad5 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -1,5 +1,5 @@
 mailto(rsync-bugs@samba.org)
-manpage(rsync)(1)(19 Feb 2006)()()
+manpage(rsync)(1)(11 Mar 2006)()()
 manpagename(rsync)(faster, flexible replacement for rcp)
 manpagesynopsis()
 
@@ -587,8 +587,8 @@ receiving side into an identical symlink, and then attempt to transfer
 "path/foo/file", which might fail if the duplicated symlink did not point
 to a directory on the receiving side.  Another way to avoid this sending of
 a symlink as an implied directory is to use bf(--copy-unsafe-links), or
-bf(--copy-dirlinks) (which will also affect symlinks to directories in the
-rest of the transfer).
+bf(--copy-dirlinks) (both of which also affect symlinks in the rest of the
+transfer -- see their descriptions for full details).
 
 dit(bf(-b, --backup)) With this option, preexisting destination files are
 renamed as each file is transferred or deleted.  You can control where the
@@ -1453,7 +1453,7 @@ dit(bf(--stats)) This tells rsync to print a verbose set of statistics
 on the file transfer, allowing you to tell how effective the rsync
 algorithm is for your data.
 
-The current statistics are as follows: itemize(
+The current statistics are as follows: quote(itemize(
   it() bf(Number of files) is the count of all "files" (in the generic
   sense), which includes directories, symlinks, etc.
   it() bf(Number of files transferred) is the count of normal files that
@@ -1483,7 +1483,7 @@ The current statistics are as follows: itemize(
   rsync received by the client side from the server side.  "Non-message"
   bytes means that we don't count the bytes for a verbose message that the
   server sent to us, which makes the stats more consistent.
-)
+))
 
 dit(bf(-8, --8-bit-output)) This tells rsync to leave all high-bit characters
 unescaped in the output instead of trying to test them to see if they're
@@ -1657,13 +1657,18 @@ must not be world readable. It should contain just the password as a
 single line.
 
 dit(bf(--list-only)) This option will cause the source files to be listed
-instead of transferred.  This option is inferred if there is no destination
-specified, so its main uses are: (1) to turn a copy command that includes a
+instead of transferred.  This option is inferred if there is a single source
+arg and no destination specified, so its main uses are: (1) to turn a copy
+command that includes a
 destination arg into a file-listing command, (2) to be able to specify more
 than one local source arg (note: be sure to include the destination), or
 (3) to avoid the automatically added "bf(-r --exclude='/*/*')" options that
 rsync usually uses as a compatibility kluge when generating a non-recursive
-listing.
+listing.  Caution: keep in mind that a source arg with a wild-card is expanded
+by the shell into multiple args, so it is never safe to try to list such an arg
+without using this option.  For example:
+
+verb(    rsync -av --list-only foo* dest/)
 
 dit(bf(--bwlimit=KBPS)) This option allows you to specify a maximum
 transfer rate in kilobytes per second. This option is most effective when
@@ -1875,7 +1880,6 @@ itemize(
   of the transfer.
   it() if the pattern ends with a / then it will only match a
   directory, not a file, link, or device.
-
   it() rsync chooses between doing a simple string match and wildcard
   matching by checking if the pattern contains one of these three wildcard
   characters: '*', '?', and '[' .
@@ -2487,7 +2491,7 @@ url(http://rsync.samba.org/)(http://rsync.samba.org/)
 
 manpagesection(VERSION)
 
-This man page is current for version 2.6.7pre2 of rsync.
+This man page is current for version 2.6.7 of rsync.
 
 manpagesection(CREDITS)