Rewritten rsync man page

CSights csights at
Thu Aug 9 17:13:32 GMT 2007

Hi Matt,
	Sorry I didn't write earlier, hopefully my suggestions are still useful.  
Also, I'm not subscribed to the rsync list so I might duplicate or conflict 
with other suggestions you've received. :)
	The first suggestion is that the order of the options listed be changed so 
that the least esoteric ones are placed before (as much as the grouping 
allows) the more often used ones.  For example, some of the more often used 
groups are "Source File Selection", "Deletion", and "Name-based filter rules"
	I like the way a default action is included in the short option descriptions.
	Perhaps -H should be under "Destination file handling" rather 
than "Attributes"->"Others"?
	In "HOW RSYNC WORKS" the server might be on the local computer. :)
	"If  the  check  passes,  the  generator  applies" -> "If  the  quick check  
passes,  the  generator  applies" .  Might as well use the bolded phrase 
again!  (I think "quick check" is not very descriptive. "file data sameness 
check", "file sameness check", or "sameness check" seem more informative).
	For the part starting "For  each  regular file, it compares", here is a 
	"For  each  regular file, it compares the information specified by the "quick 
check" rule to determine whether the file's data are identical.  If the 
information match, then files are assumed to be the same and the generator 
applies any preserved source attributes to the destination file (tweaks it)."

	I think the description of how rsync works is nice and, if nothing else, this 
should be added to the existing man page.

Thanks Matt,

On Saturday 04 August 2007 19:26, Matt McCutchen wrote:
> Dear Wayne, C Sights, and list,
> I have started working on my rewritten version of the rsync man page.
> So far, I have redone the top of the man page and the list of options;
> I improved many of the one-line option descriptions.  The yodl and man
> versions of my man page are available here and here:
> What do you all think so far?  Am I going in the right direction?
> Matt

More information about the rsync mailing list