[Bug 2690] New: SYNOPSIS "rsync [OPTION]... SRC [SRC]... DEST" incorrect

[samba-bugs at samba.org]

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: wayned at samba.org
        ReportedBy: Raf_Schietekat at ieee.org
         QAContact: rsync-qa at samba.org


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]... [USER@]HOST:DEST
rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST
rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST
rsync [OPTION]... [USER@]HOST:SRC [DEST]
rsync [OPTION]... [USER@]HOST::SRC [DEST]
rsync [OPTION]... rsync://[USER@]HOST[: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.