X-Git-Url: https://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fglibc-functions%2Fgetopt_long_only.texi;h=309c5b6b7008497c1f26e1219b28bbf968f4c0d4;hb=6229a28f54486e8c623fd516db498a289d5ac0d7;hp=ed6cd7bad292265b235fa72894d648e40feb5797;hpb=c0c5acfbe255f5542bc1c81c7aec223d95e504a6;p=gnulib.git

diff --git a/doc/glibc-functions/getopt_long_only.texi b/doc/glibc-functions/getopt_long_only.texi
index ed6cd7bad..309c5b6b7 100644
--- a/doc/glibc-functions/getopt_long_only.texi
+++ b/doc/glibc-functions/getopt_long_only.texi
@@ -7,14 +7,30 @@ 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.
 @item
+The value of @code{optind} after a missing required argument is wrong
+on some platforms:
+MacOS 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:
 Cygwin 1.7.0.
 @item
+Some implementations fail to reset state, including re-checking
+@env{POSIXLY_CORRECT}, when @code{optind} is set to @samp{0}:
+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.
@@ -27,9 +43,10 @@ OSF/1 5.1, mingw, Interix 3.5.
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-The glibc implementation allows a complete reset of the environment,
-including re-checking for @env{POSIXLY_CORRECT}, by setting
-@code{optind} to 0.  Other implementations provide @code{optreset},
-causing a reset by setting it non-zero, although it does not
-necessarily re-read @env{POSIXLY_CORRECT}.
+Some implementations return success instead of reporting an ambiguity
+if user's option is a prefix of two long options with the same outcome:
+FreeBSD.
+@item
+The GNU Coding Standards discourage the use of @code{getopt_long_only}
+in new programs.
 @end itemize