revise node structure for new fdl.texi
[gnulib.git] / doc / functions / iconv_open.texi
1 @node iconv_open
2 @section @code{iconv_open}
3 @findex iconv_open
4
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/iconv_open.html}
6
7 Gnulib module: iconv and iconv_open
8
9 Portability problems fixed by either Gnulib module @code{iconv} or @code{iconv_open}:
10 @itemize
11 @item
12 GNU libiconv is not found if installed in @file{$PREFIX/lib}.
13 @item
14 No converter from EUC-JP to UTF-8 is provided on some platforms:
15 HP-UX 11.
16 @end itemize
17
18 Portability problems fixed by Gnulib module @code{iconv_open}:
19 @itemize
20 @item
21 This function recognizes only non-standard aliases for many encodings (not
22 the IANA registered encoding names) on many platforms:
23 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1.
24 @end itemize
25
26 Portability problems not fixed by Gnulib:
27 @itemize
28 @item
29 This function is missing on some platforms:
30 MacOS X 10.3, FreeBSD 6.0, OpenBSD 3.8, Cygwin, mingw, BeOS,
31 when GNU libiconv is not installed.
32 @item
33 The set of supported encodings and conversions is system dependent.
34 @end itemize