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

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