[Bug 970] document -- as option/non-option separator

[bugzilla-daemon at mindrot.org]

http://bugzilla.mindrot.org/show_bug.cgi?id=970

           Summary: document -- as option/non-option separator
           Product: Portable OpenSSH
           Version: -current
          Platform: All
               URL: http://bugs.debian.org/289401
        OS/Version: Linux
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Documentation
        AssignedTo: openssh-bugs at mindrot.org
        ReportedBy: cjwatson at debian.org
   Estimated Hours: 0.00


The OpenSSH utilities use getopt(), which according to
http://www.opengroup.org/onlinepubs/009695399/functions/getopt.html, manual
pages on the BSD and Linux systems I checked, and openbsd-compat/getopt.c, stops
scanning options when it encounters a "--". Greg Kochanski noted in a Debian bug
report that it's useful for reliable scripting purposes to be able to rely on
this feature, because it eliminates the possibility that a wildcard or a
variable expansion might expand to a valid option.

Since it seems generally useful and available, could this feature be documented?
Thanks.



------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.