rsync - Sep 2006 - Improvements to --progress in man page

Attached is a patch that improves the discussion of --progress in the
rsync man page.  It makes one badly needed update: the man page needs
to use "(xfer#5, to-check=169/396)" instead of "(5, 57.1% of
396)".
In addition, I tried to make the rest of the discussion more precise.

Matt
-------------- next part --------------
A non-text attachment was scrubbed...
Name: man-progress.diff
Type: text/x-patch
Size: 2656 bytes
Desc: not available
Url :
http://lists.samba.org/archive/rsync/attachments/20060922/aa596b30/man-progress.bin

On Fri, Sep 22, 2006 at 06:33:35PM -0400, Matt McCutchen
wrote:
> Attached is a patch that improves the discussion of --progress in the
> rsync man page.  It makes one badly needed update: the man page needs
> to use "(xfer#5, to-check=169/396)" instead of "(5, 57.1% of
396)".
> In addition, I tried to make the rest of the discussion more precise.
Thanks!  Those are some good changes.  I tweaked the text a little bit
more, and committed the result.

..wayne..

On 9/22/06, Wayne Davison <wayned@samba.org>
wrote:
> Thanks!  Those are some good changes.  I tweaked the text a little bit
> more, and committed the result.
Looks good.

I notice you took out both references to the "overall transfer",
presumably to avoid confusion with transfers of individual regular
files.  If that is the goal, the man page contains many other
occurrences of "transfer" that refer to the entire run; you might want
to change those as well.

When I said "169 of the 396 files in the overall transfer have not yet
been considered by the receiver", I was trying to include all the
things recv_generator can do.  However, since the progress message
indicates where the receiver (not the generator) is in the file list,
perhaps your language is more correct.

That reminds me: we need a term that refers to both the receiver and
the generator, or we need to rename the receiver to the "transfer
receiver" so that we can say "receiver" to refer to both it and
the
generator.

Matt