From: Wayne Davison <wayned@samba.org>
Date: Tue, 13 Sep 2011 22:58:25 +0000 (-0700)
Subject: Added "SORTED TRANSFER ORDER" manpage section.
X-Git-Tag: v3.1.0pre1~79
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=db0443cf9064fc2feee303845a013ccf648a8f49;p=thirdparty%2Frsync.git

Added "SORTED TRANSFER ORDER" manpage section.
---

diff --git a/rsync.yo b/rsync.yo
index 0670af5e..3c0bfc00 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -281,6 +281,19 @@ daemon (including stand-alone and inetd configurations).
 If you're using one of the remote-shell transports for the transfer, there is
 no need to manually start an rsync daemon.
 
+manpagesection(SORTED TRANSFER ORDER)
+
+Rsync always sorts the specified filenames into its internal transfer list.
+This handles the merging together of the contents of identically named
+directories, makes it easy to remove duplicate filenames, and may confuse
+someone when the files are transferred in a different order than what was
+given on the command-line.
+
+If you need a particular file to be transferred prior to another, either
+separate the files into different rsync calls, or consider using
+bf(--delay-updates) (which doesn't affect the sorted transfer order, but
+does make the final file-updating phase happen much more rapidly).
+
 manpagesection(EXAMPLES)
 
 Here are some examples of how I use rsync.