Sections 2 and 3 have RETURN VALUES, not DIAGNOSTICS

Remove workaround for ancient HTML generation code.

Remove trailing whitespace.

Bring getopt(3) inline with getopt_long(3): recognize option:: as an optional
option.

Use .In for header files instead of .Ar Pa and variations.

Slight syncing with OpenBSD version.

Use standard section headers, suggested by jmc@openbsd. Sort sections.

Pull over some improvements from OpenBSD's v1.26 of this file, including
SEE ALSO and RETURN VALUES sections.

getopt return value has to be held in int, not char.

Fix typos and declare a missing variable in example. From Quentin Garnier in PR 22733.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Quote question mark.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

fix sample code. from openbsd.

generate & symbolically

Generate <>& symbolically.

Drop unnecessary whitespace and .Pp, sort SEE ALSO, sort sections,
and some minor fixes.

Added a tab before a '}' to put the brace in the right place.

Change the declaration of the argv argument to getopt(3) from "char * const *"
(as originally declared in System V) to "char * const []", as was done in
1003.2 and subsequently propagated into XPG4.

Change the declaration of the argv argument to getopt(3) from "char * const *"
(as originally declared in System V) to "char * const []", as was done in
1003.2 and subsequently propagated into XPG4.
From Andrew Cagney in PR lib/8930.

show more ...

Typos (from OpenBSD)

Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

getopt() does not return -1 when encountering an unknown option.
Also, minor KNF nit in an example.

English.

fix mdoc references and mistakes

add LIBRARY section to man page