openbsd/src/lib/libc/stdlib/getopt.3, branch OPENBSD_7_9_BASE

If a command or interface first appeared in PWB/UNIX, UNIX System III or

2022-07-25T02:25:55+00:00

UNIX System V mention it. Only do so in manual pages with a pre-existing HISTORY section. Prompted by the comparison of System V and BSD commands and interfaces in Sun's "System V Enhancements Overview" document. checked against manuals on bitsavers, TUHS archive and CSRG archive CDs ok jmc@ schwarze@

For open/openat, if the flags parameter does not contain O_CREAT, the

2021-10-24T21:24:20+00:00

3rd (variadic) mode_t parameter is irrelevant. Many developers in the past have passed mode_t (0, 044, 0644, or such), which might lead future people to copy this broken idiom, and perhaps even believe this parameter has some meaning or implication or application. Delete them all. This comes out of a conversation where tb@ noticed that a strange (but intentional) pledge behaviour is to always knock-out high-bits from mode_t on a number of system calls as a safety factor, and his bewilderment that this appeared to be happening against valid modes (at least visually), but no sorry, they are all irrelevant junk. They could all be 0xdeafbeef. ok millert

Follow style(9) and drop lint /* NOTREACHED */ annotations from

2016-01-04T19:43:13+00:00

the examples. Diff from Juuso Lapinlampi < wub () partyvan ! eu >, thanks! ok schwarze@

Don't fake a bulleted list by prefixing items with 'o'.

2015-11-24T09:03:16+00:00

ok jmc@

obvious .Pa fixes; found with mandocdb(8)

2014-01-21T03:15:45+00:00

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze

2013-06-05T03:39:23+00:00

Fix PR 6267: recheck POSIXLY_CORRECT each time getopt_long() starts a new

2011-03-05T22:10:11+00:00

argv and don't suppress the handling of leading '-' in optstring when POSIXLY_CORRECT is set. Based on patch from Eric Blake. ok and manpage update from millert@, manpage ok jmc@

document that no leading whitespace is permitted between the option and

2009-04-12T23:13:36+00:00

argument if the argument is deemed to be optional ('::'). feedback and ok jmc@ and millert@

convert to new .Dd format;

2007-05-31T19:20:26+00:00

Support for optional args separated with whitespace was removed

2007-04-10T20:35:34+00:00

some time ago--it caused too many problems.