Made the new msg2sndr handling even better.

[rsync/rsync.git] / rsync.yo

diff --git a/rsync.yo b/rsync.yo
index 96ce4bb..6c1c8ad 100644 (file)
--- a/rsync.yo
+++ b/rsync.yo
@@ -1,5 +1,5 @@
 mailto(rsync-bugs@samba.org)
 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()
 
 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
 "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
 
 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.
 
 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
   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.
   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
 
 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
 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
 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
 
 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.
   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 '[' .
   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)
 
 
 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)
 
 
 manpagesection(CREDITS)