Merge branch 'stable'
[gnulib.git] / doc / glibc-functions / getopt_long.texi
1 @node getopt_long
2 @subsection @code{getopt_long}
3 @findex getopt_long
4
5 Gnulib module: getopt-gnu
6
7 Portability problems fixed by Gnulib:
8 @itemize
9 @item
10 This function is missing on some platforms:
11 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, MSVC 9, Interix 3.5.
12 @item
13 The function @code{getopt_long} does not obey the combination of
14 @samp{+} and @samp{:} flags in the options string on some platforms:
15 glibc 2.11.
16 @item
17 The use of @samp{W;} in the optstring argument to does not always
18 allow @code{-W foo} to behave synonymously with @code{--foo}:
19 glibc 2.11.
20 @item
21 The function @code{getopt_long} does not support the @samp{+} flag in
22 the options string on some platforms:
23 MacOS X 10.5, AIX 5.2, OSF/1 5.1, Solaris 10.
24 @item
25 The value of @code{optind} after a missing required argument is wrong
26 on some platforms:
27 MacOS 10.5.
28 @item
29 The function @code{getopt_long} does not obey the @samp{-} flag in the
30 options string when @env{POSIXLY_CORRECT} is set on some platforms:
31 Cygwin 1.7.0.
32 @item
33 Some implementations fail to reset state, including re-checking
34 @env{POSIXLY_CORRECT}, when @code{optind} is set to @samp{0}:
35 NetBSD, Cygwin 1.7.0.
36 @item
37 The function @code{getopt_long} does not support options with optional
38 arguments on some platforms:
39 MacOS X 10.5, OpenBSD 4.0, AIX 5.2, IRIX 6.5, Solaris 11 2010-11, Cygwin 1.5.x.
40 @item
41 This function crashes if the option string includes @code{W;} but
42 there are no long options, on some platforms:
43 glibc 2.14.
44 @end itemize
45
46 Portability problems not fixed by Gnulib:
47 @itemize
48 @end itemize