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

[samba-bugs at samba.org]

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.