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.

branches: 1.32.12; 1.32.22;
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.

branches: 1.19.6;
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.
From Andrew Cagney in PR lib/8930.

Typos (from OpenBSD)

branches: 1.16.6;
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

update to lite-2

RCS Id Police.

optarg -> optstring and rewording from Brian Grayson in PR misc/3697.

merge back in our changes (mostly POSIX.2 pedanticism)

sync with 44lite

Fix spelling errors.

Document (well, really just mention) external variable optopt.
Add trailing semicolons to the extern variables in the SYNOPSIS section
like all of the other manpages with extern variables.

POSIX.2 requires special behavior if the first character of the optstring
argument is a colon.
Updated the manpage to reflect the above change, and expanded the example to
the one used by the POSIX.2 rationale, as it more clearly explains how
the new behavior is to be used.
The manpage should be rewritten --- it is much more confusing than it
should be.

POSIX.2 has changed getopt to return -1 instead of EOF (to decouple getopt()
from standard i/o). This change is more pedantic than functional as EOF
is defined to be -1.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Remove workaround for ancient HTML generation code.

Remove trailing whitespace.

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

branches: 1.32.12; 1.32.22;
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.

branches: 1.19.6;
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.
From Andrew Cagney in PR lib/8930.

Typos (from OpenBSD)

branches: 1.16.6;
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

update to lite-2

RCS Id Police.

optarg -> optstring and rewording from Brian Grayson in PR misc/3697.

merge back in our changes (mostly POSIX.2 pedanticism)

sync with 44lite

Fix spelling errors.

Document (well, really just mention) external variable optopt.
Add trailing semicolons to the extern variables in the SYNOPSIS section
like all of the other manpages with extern variables.

POSIX.2 requires special behavior if the first character of the optstring
argument is a colon.
Updated the manpage to reflect the above change, and expanded the example to
the one used by the POSIX.2 rationale, as it more clearly explains how
the new behavior is to be used.
The manpage should be rewritten --- it is much more confusing than it
should be.

POSIX.2 has changed getopt to return -1 instead of EOF (to decouple getopt()
from standard i/o). This change is more pedantic than functional as EOF
is defined to be -1.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision