rsync - Nov 2012 - [Bug 9427] New: Description of "--max-delete=" in manual page needs clarification

https://bugzilla.samba.org/show_bug.cgi?id=9427

           Summary: Description of "--max-delete=" in manual page
needs
                    clarification
           Product: rsync
           Version: 3.1.0
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P5
         Component: core
        AssignedTo: wayned at samba.org
        ReportedBy: shop at open-t.co.uk
         QAContact: rsync-qa at samba.org


The description of "--max-delete=" option in the man page is a bit
ambiguous
and open to interpretation:

"--max-delete=NUM
       This  tells  rsync not to delete more than NUM files or directo?
       ries.  If that limit is exceeded, a warning is output and  rsync
       exits with an error code of 25 (new for 3.0.0)."

The above could be easily interpreted to mean that rsync aborts the current
operation as soon as "max-delete" is reached. However, according to my
tests,
that is not the case - rsync only aborts *deleting* files, but continues with
updates/transfers to the end. By the way, I think the current behaviour is good
and desirable - I just think that the man page could clarify that rsync will
only abort the deletions, but continue with the updates/transfers to the end of
the current fileset. Otherwise some users might get quite different results
from what they expect when using this option.

-- 
Configure bugmail: https://bugzilla.samba.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

https://bugzilla.samba.org/show_bug.cgi?id=9427

Wayne Davison <wayned at samba.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED

--- Comment #1 from Wayne Davison <wayned at samba.org> 2013-05-27
00:07:26 UTC ---
Thanks for the suggestion -- this was improved a few weeks ago.

-- 
Configure bugmail: https://bugzilla.samba.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.