summaryrefslogtreecommitdiff
path: root/gnulib/doc/glibc-functions/getopt_long_only.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/glibc-functions/getopt_long_only.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/glibc-functions/getopt_long_only.texi56
2 files changed, 56 insertions, 0 deletions
diff --git a/gnulib b/gnulib
deleted file mode 160000
-Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1
diff --git a/gnulib/doc/glibc-functions/getopt_long_only.texi b/gnulib/doc/glibc-functions/getopt_long_only.texi
new file mode 100644
index 0000000..85e8b02
--- /dev/null
+++ b/gnulib/doc/glibc-functions/getopt_long_only.texi
@@ -0,0 +1,56 @@
+@node getopt_long_only
+@subsection @code{getopt_long_only}
+@findex getopt_long_only
+
+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 11 2010-11, Cygwin 1.5.x.
+@item
+This function is missing on some platforms:
+MacOS 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
+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