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

           Summary: SYNOPSIS "rsync [OPTION]... SRC [SRC]... DEST" incorrect
           Product: rsync
           Version: 2.6.4
          Platform: All
               URL: http://rsync.samba.org/ftp/rsync/rsync.html
        OS/Version: All
            Status: NEW
          Severity: trivial
          Priority: P3
         Component: core
        AssignedTo: [EMAIL PROTECTED]
        ReportedBy: [EMAIL PROTECTED]
         QAContact: [EMAIL PROTECTED]


The rsync man page SYNOPSIS line "rsync [OPTION]... SRC [SRC]... DEST" must be
"rsync [OPTION]... SRC [SRC]... [DEST]" instead (for listing remote files).


While I'm here, the SYNOPSIS seems less confusing this way (easier to see the
pattern):

rsync [OPTION]... SRC [SRC]... DEST
rsync [OPTION]... SRC [SRC]... [EMAIL PROTECTED]:DEST
rsync [OPTION]... SRC [SRC]... [EMAIL PROTECTED]::DEST
rsync [OPTION]... SRC [SRC]... rsync://[EMAIL PROTECTED]:PORT]/DEST
rsync [OPTION]... [EMAIL PROTECTED]:SRC [DEST]
rsync [OPTION]... [EMAIL PROTECTED]::SRC [DEST]
rsync [OPTION]... rsync://[EMAIL PROTECTED]:PORT]/SRC [DEST]


Likewise, GENERAL requires the reader to carefully read everything and try to
induce the logic behind it. It would be better if the reader would only need to
use deduction instead. There's also the mismatch between :: equals rsync: for
direct communication and only :: when using a remote shell to complicate 
matters.


(This report's rsync version may be irrelevant, the man page mentions "30 Mar
2005".)

-- 
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.
-- 
To unsubscribe or change options: https://lists.samba.org/mailman/listinfo/rsync
Before posting, read: http://www.catb.org/~esr/faqs/smart-questions.html

Reply via email to