test-getopt: test stderr behavior
[gnulib.git] / doc / glibc-functions / getopt_long_only.texi
1 @node getopt_long_only
2 @subsection @code{getopt_long_only}
3 @findex getopt_long_only
4
5 Gnulib module: getopt-gnu
6
7 Portability problems fixed by Gnulib:
8 @itemize
9 @item
10 The function @code{getopt_long_only} does not support the @samp{+}
11 flag in the options string on some platforms:
12 MacOS X 10.5, AIX 5.2, OSF/1 5.1, Solaris 10.
13 @item
14 The function @code{getopt_long_only} does not obey the @samp{-} flag
15 in the options string when @env{POSIXLY_CORRECT} is set on some platforms:
16 Cygwin 1.7.0.
17 @item
18 Some implementations fail to reset state, including re-checking
19 @env{POSIXLY_CORRECT}, when @code{optind} is set to @samp{0}:
20 NetBSD, Cygwin 1.7.0.
21 @item
22 The function @code{getopt_long_only} does not support options with
23 optional arguments on some platforms:
24 MacOS X 10.5, OpenBSD 4.0, AIX 5.2, Solaris 10, Cygwin 1.5.x.
25 @item
26 This function is missing on some platforms:
27 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, AIX 5.1, HP-UX 11, IRIX 6.5,
28 OSF/1 5.1, mingw, Interix 3.5.
29 @end itemize
30
31 Portability problems not fixed by Gnulib:
32 @itemize
33 @item
34 The glibc extension of using @samp{W;} in the optstring argument to
35 allow @code{-W foo} to behave synonymously with @code{--foo} is not
36 very reliable.
37 @item
38 Some implementations return success instead of reporting an ambiguity
39 if user's option is a prefix of two long options with the same flag:
40 FreeBSD.
41 @item
42 Mixing a leading @samp{-} or @samp{+} with a leading @samp{:} in the
43 optstring argument has inconsistent effects across platforms.
44 @end itemize