Mention that sorting the --files-from input is helpful.

diff --git a/rsync.yo b/rsync.yo
index a523f23b675e52f62e8e62fa3937dc7a6e4e271f..0bb9b58b63d51a3910daa15d86c5479c3417f671 100644 (file)
--- a/rsync.yo
+++ b/rsync.yo
@@ -1491,6 +1491,12 @@ bf(--files-from) filenames are being sent from one host to another, the
 filenames will be translated from the sending host's charset to the
 receiving host's charset.
 
 filenames will be translated from the sending host's charset to the
 receiving host's charset.
 

+NOTE: sorting the list of files in the --files-from input helps rsync to be
+more efficient, as it will avoid re-visiting the path elements that are shared
+between adjacent entries.  If the input is not sorted, some path elements
+(implied directories) may end up being scanned multiple times, and rsync will
+eventually unduplicate them after they get turned into file-list elements.
+

 dit(bf(-0, --from0)) This tells rsync that the rules/filenames it reads from a
 file are terminated by a null ('\0') character, not a NL, CR, or CR+LF.
 This affects bf(--exclude-from), bf(--include-from), bf(--files-from), and any
 dit(bf(-0, --from0)) This tells rsync that the rules/filenames it reads from a
 file are terminated by a null ('\0') character, not a NL, CR, or CR+LF.
 This affects bf(--exclude-from), bf(--include-from), bf(--files-from), and any