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

samba-bugs at samba.org samba-bugs at samba.org
Sun May 8 20:02:17 GMT 2005


           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

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

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.

More information about the rsync mailing list