X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fglibc-functions%2Fgetopt_long_only.texi;h=0053844e859e4902153cd7ab13ece695d850f6ec;hb=5a448a463a290b59549f2ee1cf6c1b01a6043f45;hp=edc832be27806be90ce796c9d9dcb37a01265334;hpb=d711c3032e93195bfb11d703f86af745a873e121;p=gnulib.git

diff --git a/doc/glibc-functions/getopt_long_only.texi b/doc/glibc-functions/getopt_long_only.texi
index edc832be2..0053844e8 100644
--- a/doc/glibc-functions/getopt_long_only.texi
+++ b/doc/glibc-functions/getopt_long_only.texi
@@ -7,13 +7,21 @@ Gnulib module: getopt-gnu
 Portability problems fixed by Gnulib:
 @itemize
 @item
+The function @code{getopt_long_only} does not obey the combination of
+@samp{+} and @samp{:} flags in the options string on some platforms:
+glibc 2.11.
+@item
+The use of @samp{W;} in the optstring argument to does not always
+allow @code{-W foo} to behave synonymously with @code{--foo}:
+glibc 2.11.
+@item
 The function @code{getopt_long_only} does not support the @samp{+}
 flag in the options string on some platforms:
-MacOS X 10.5, AIX 5.2, OSF/1 5.1, Solaris 10.
+Mac OS X 10.5, AIX 5.2, OSF/1 5.1, Solaris 10.
 @item
 The value of @code{optind} after a missing required argument is wrong
 on some platforms:
-MacOS 10.5.
+Mac OS X 10.5.
 @item
 The function @code{getopt_long_only} does not obey the @samp{-} flag
 in the options string when @env{POSIXLY_CORRECT} is set on some platforms:
@@ -25,24 +33,24 @@ NetBSD, Cygwin 1.7.0.
 @item
 The function @code{getopt_long_only} does not support options with
 optional arguments on some platforms:
-MacOS X 10.5, OpenBSD 4.0, AIX 5.2, Solaris 10, Cygwin 1.5.x.
+Mac OS X 10.5, OpenBSD 4.0, AIX 5.2, Solaris 11 2010-11, Cygwin 1.5.x.
 @item
 This function is missing on some platforms:
-MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, AIX 5.1, HP-UX 11, IRIX 6.5,
-OSF/1 5.1, mingw, Interix 3.5.
+Mac OS X 10.3, FreeBSD 5.2.1, NetBSD 5.0, Minix 3.1.8, AIX 5.1, HP-UX 11, IRIX 6.5,
+OSF/1 5.1, mingw, MSVC 9, Interix 3.5.
+@item
+This function crashes if the option string includes @code{W;} but
+there are no long options, on some platforms:
+glibc 2.14.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-The glibc extension of using @samp{W;} in the optstring argument to
-allow @code{-W foo} to behave synonymously with @code{--foo} is not
-very reliable.
-@item
 Some implementations return success instead of reporting an ambiguity
-if user's option is a prefix of two long options with the same flag:
+if user's option is a prefix of two long options with the same outcome:
 FreeBSD.
 @item
-Mixing a leading @samp{-} or @samp{+} with a leading @samp{:} in the
-optstring argument has inconsistent effects across platforms.
+The GNU Coding Standards discourage the use of @code{getopt_long_only}
+in new programs.
 @end itemize