rsync - May 2006 - DO NOT REPLY [Bug 3749] New: rsync --help misleading information

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

           Summary: rsync --help misleading information
           Product: rsync
           Version: 2.6.0
          Platform: All
        OS/Version: Windows 2000
            Status: NEW
          Severity: trivial
          Priority: P3
         Component: core
        AssignedTo: wayned@samba.org
        ReportedBy: jan@dewal.net
         QAContact: rsync-qa@samba.org


about the --delete parameter, is shows 'not so logical' information

     --ignore-existing       ignore files that already exist on the receiving
side
     --delete                delete files that don't exist on the sending
side
     --delete-excluded       also delete excluded files on the receiving side

Depending on, weither your sending a backup to a server or fetching a backup
from a server, this help does not make sense. Please change the help code into
something more logical, in example: 

 --delete delete files that don't exist on the target side or directory

keywords like: "target" or "source" would be mutch easyer to
understand instead
of figuring it out by trial and error! Ive figured this for local copys, dont
know if this help conflicts with daemon mode :P


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

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





------- Comment #1 from hashproduct@verizon.net  2006-05-03 17:16 MST -------
I don't think the terms sender and receiver are problematic; they're
equivalent
to source and destination, respectively.  However, some of the help is unclear
and/or ambiguous.  If --delete makes rsync "delete files that don't
exist on
the sending side", does rsync delete files from the sender or does it
delete
files that the sender does not have?  Let me propose this:

--delete: deletes receiver files that are unmatched on sender

And some improvements to --existing and --ignore-existing:

--existing: skip creating new files on receiver
--ignore-existing: skip updating files that already exist on receiver


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

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


jan@dewal.net changed:

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




------- Comment #2 from jan@dewal.net  2006-05-07 15:31 MST -------
Just leave it like it is now... ive givin it some tought .. it does seem to do
it like this... :)


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

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





------- Comment #3 from wayned@samba.org  2006-05-07 15:46 MST -------
FYI, I didn't like the wording of the --delete option, so I had just
recently
improved it in the CVS version.  I also improved the wording of the
existing/ignore-existing options.


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