Mention indirect conversion problem.

diff --git a/ChangeLog b/ChangeLog
index 7ddaf51..06de474 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2009-08-30  Bruno Haible  <bruno@clisp.org>
 
+       * doc/posix-functions/iconv_open.texi: Mention indirect conversion
+       problem.
+
+2009-08-30  Bruno Haible  <bruno@clisp.org>
+
        Work around iconv_open problem on Solaris.
        * lib/iconv_open-solaris.gperf: New file.
        * m4/iconv_open.m4 (gl_FUNC_ICONV_OPEN): Also handle Solaris.

diff --git a/doc/posix-functions/iconv_open.texi b/doc/posix-functions/iconv_open.texi
index 74e8106..8e44b1a 100644 (file)
--- a/doc/posix-functions/iconv_open.texi
+++ b/doc/posix-functions/iconv_open.texi
@@ -38,5 +38,11 @@ This function is missing on some platforms:
 MacOS X 10.3, FreeBSD 6.0, OpenBSD 3.8, IRIX 5.3, Cygwin, mingw, BeOS,
 when GNU libiconv is not installed.
 @item
+For some encodings A and B, this function cannot convert directly from A to B,
+although an indirect conversion from A through UTF-8 to B is possible.  This
+occurs on some platforms: Solaris 10.  ---  Gnulib provides a higher-level
+facility @code{striconveh} (a wrapper around @code{iconv}) that deals with
+this problem.
+@item
 The set of supported encodings and conversions is system dependent.
 @end itemize