+2021-01-03 Bruno Haible <bruno@clisp.org>
+
+ iconv, iconv_open: Improve documentation.
+ Reported by Noah Misch <noah@leadboat.com> in
+ <https://lists.gnu.org/archive/html/bug-gnulib/2020-12/msg00172.html>.
+ * doc/posix-functions/iconv_open.texi: Add new paragraph "Portability
+ problems handled by Gnulib".
+ * doc/posix-functions/iconv.texi: Likewise. Update info about AIX.
+ * m4/iconv.m4 (AM_ICONV_LINK): Improve comments.
+
2021-01-03 Bruno Haible <bruno@clisp.org>
iconv-h: Fix module description.
@itemize
@item
GNU libiconv is not found if installed in @file{$PREFIX/lib}.
+@end itemize
+
+Portability problems handled by Gnulib
+(in the sense that @code{HAVE_ICONV} does not get defined if the system's
+@code{iconv} function has this problem):
+@itemize
@item
Failures are not distinguishable from successful returns on some platforms:
-AIX 5.1, Solaris 10.
+AIX 5.1..7.2, Solaris 10.
@item
A buffer overrun can occur on some platforms:
AIX 6.1..7.1.
@itemize
@item
GNU libiconv is not found if installed in @file{$PREFIX/lib}.
+@end itemize
+
+Portability problems handled by either Gnulib module @code{iconv} or @code{iconv_open}
+(in the sense that @code{HAVE_ICONV} does not get defined if the system's
+@code{iconv_open} function has this problem):
+@itemize
@item
No converter from EUC-JP to UTF-8 is provided on some platforms:
HP-UX 11.
-# iconv.m4 serial 23
+# iconv.m4 serial 24
dnl Copyright (C) 2000-2002, 2007-2014, 2016-2021 Free Software Foundation,
dnl Inc.
dnl This file is free software; the Free Software Foundation
#endif
]],
[[int result = 0;
- /* Test against AIX 5.1 bug: Failures are not distinguishable from successful
- returns. */
+ /* Test against AIX 5.1...7.2 bug: Failures are not distinguishable from
+ successful returns. This is even documented in
+ <https://www.ibm.com/support/knowledgecenter/ssw_aix_72/i_bostechref/iconv.html> */
{
iconv_t cd_utf8_to_88591 = iconv_open ("ISO8859-1", "UTF-8");
if (cd_utf8_to_88591 != (iconv_t)(-1))