.\" SUCH DAMAGE.
.\"
.\" @(#)getopt.3 8.5 (Berkeley) 4/27/95
-.\" $FreeBSD: src/lib/libc/stdlib/getopt_long.3,v 1.11 2004/03/06 14:47:49 ache Exp $
+.\" $FreeBSD: src/lib/libc/stdlib/getopt_long.3,v 1.13 2005/01/20 09:17:04 ru Exp $
.\"
.Dd April 1, 2000
.Dt GETOPT_LONG 3
no argument to the option is expect
.It Dv required_argument
an argument to the option is required
-.It Li optional_argument
+.It Dv optional_argument
an argument to the option may be presented.
.El
.Pp
If the
.Fa flag
field in
-.Li struct option
+.Vt "struct option"
is
.Dv NULL ,
.Fn getopt_long
.Ql \&?
if the user specified an unknown or ambiguous option, and
\-1 when the argument list has been exhausted.
+.Sh ENVIRONMENT
+.Bl -tag -width ".Ev POSIXLY_CORRECT"
+.It Ev POSIXLY_CORRECT
+If set, option processing stops when the first non-option is found and
+a leading
+.Ql -
+or
+.Ql +
+in the
+.Fa optstring
+is ignored.
+.El
.Sh EXAMPLES
.Bd -literal -compact
int bflag, ch, fd;
to current positions) are the same, though.
(We do fewer variable swaps.)
.El
-.Sh ENVIRONMENT
-.Bl -tag -width POSIXLY_CORRECT
-.It Ev POSIXLY_CORRECT
-If set, option processing stops when the first non-option is found and
-a leading
-.Ql -
-or
-.Ql +
-in the
-.Ar optstring
-is ignored.
-.El
.Sh SEE ALSO
.Xr getopt 3
.Sh HISTORY
.Fx 5.2 .
.Sh BUGS
The
-.Ar argv
+.Fa argv
argument is not really
-.Dv const
+.Vt const
as its elements may be permuted (unless
.Ev POSIXLY_CORRECT
is set).