summaryrefslogtreecommitdiff
path: root/jni/iconv/README
diff options
context:
space:
mode:
Diffstat (limited to 'jni/iconv/README')
-rw-r--r--jni/iconv/README170
1 files changed, 170 insertions, 0 deletions
diff --git a/jni/iconv/README b/jni/iconv/README
new file mode 100644
index 0000000..6bd35a9
--- /dev/null
+++ b/jni/iconv/README
@@ -0,0 +1,170 @@
+ GNU LIBICONV - character set conversion library
+
+This library provides an iconv() implementation, for use on systems which
+don't have one, or whose implementation cannot convert from/to Unicode.
+
+It provides support for the encodings:
+
+ European languages
+ ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
+ KOI8-R, KOI8-U, KOI8-RU,
+ CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
+ Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
+ Mac{Cyrillic,Ukraine,Greek,Turkish},
+ Macintosh
+ Semitic languages
+ ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
+ Japanese
+ EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1
+ Chinese
+ EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS,
+ BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN, ISO-2022-CN-EXT
+ Korean
+ EUC-KR, CP949, ISO-2022-KR, JOHAB
+ Armenian
+ ARMSCII-8
+ Georgian
+ Georgian-Academy, Georgian-PS
+ Tajik
+ KOI8-T
+ Kazakh
+ PT154, RK1048
+ Thai
+ ISO-8859-11, TIS-620, CP874, MacThai
+ Laotian
+ MuleLao-1, CP1133
+ Vietnamese
+ VISCII, TCVN, CP1258
+ Platform specifics
+ HP-ROMAN8, NEXTSTEP
+ Full Unicode
+ UTF-8
+ UCS-2, UCS-2BE, UCS-2LE
+ UCS-4, UCS-4BE, UCS-4LE
+ UTF-16, UTF-16BE, UTF-16LE
+ UTF-32, UTF-32BE, UTF-32LE
+ UTF-7
+ C99, JAVA
+ Full Unicode, in terms of `uint16_t' or `uint32_t'
+ (with machine dependent endianness and alignment)
+ UCS-2-INTERNAL, UCS-4-INTERNAL
+ Locale dependent, in terms of `char' or `wchar_t'
+ (with machine dependent endianness and alignment, and with OS and
+ locale dependent semantics)
+ char, wchar_t
+ The empty encoding name "" is equivalent to "char": it denotes the
+ locale dependent character encoding.
+
+When configured with the option --enable-extra-encodings, it also provides
+support for a few extra encodings:
+
+ European languages
+ CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
+ Semitic languages
+ CP864
+ Japanese
+ EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
+ Chinese
+ BIG5-2003 (experimental)
+ Turkmen
+ TDS565
+ Platform specifics
+ ATARIST, RISCOS-LATIN1
+
+It can convert from any of these encodings to any other, through Unicode
+conversion.
+
+It has also some limited support for transliteration, i.e. when a character
+cannot be represented in the target character set, it can be approximated
+through one or several similarly looking characters. Transliteration is
+activated when "//TRANSLIT" is appended to the target encoding name.
+
+libiconv is for you if your application needs to support multiple character
+encodings, but that support lacks from your system.
+
+
+Installation
+------------
+
+As usual for GNU packages:
+
+ $ ./configure --prefix=/usr/local
+ $ make
+ $ make install
+
+After installing GNU libiconv for the first time, it is recommended to
+recompile and reinstall GNU gettext, so that it can take advantage of
+libiconv.
+
+On systems other than GNU/Linux, the iconv program will be internationalized
+only if GNU gettext has been built and installed before GNU libiconv. This
+means that the first time GNU libiconv is installed, we have a circular
+dependency between the GNU libiconv and GNU gettext packages, which can be
+resolved by building and installing either
+ - first libiconv, then gettext, then libiconv again,
+or (on systems supporting shared libraries, excluding AIX)
+ - first gettext, then libiconv, then gettext again.
+Recall that before building a package for the second time, you need to erase
+the traces of the first build by running "make distclean".
+
+This library can be built and installed in two variants:
+
+ - The library mode. This works on all systems, and uses a library
+ `libiconv.so' and a header file `<iconv.h>'. (Both are installed
+ through "make install".)
+
+ To use it, simply #include <iconv.h> and use the functions.
+
+ To use it in an autoconfiguring package:
+ - If you don't use automake, append m4/iconv.m4 to your aclocal.m4
+ file.
+ - If you do use automake, add m4/iconv.m4 to your m4 macro repository.
+ - Add to the link command line of libraries and executables that use
+ the functions the placeholder @LIBICONV@ (or, if using libtool for
+ the link, @LTLIBICONV@). If you use automake, the right place for
+ these additions are the *_LDADD variables.
+ Note that 'iconv.m4' is also part of the GNU gettext package, which
+ installs it in /usr/local/share/aclocal/iconv.m4.
+
+ - The libc plug/override mode. This works on GNU/Linux, Solaris and OSF/1
+ systems only. It is a way to get good iconv support without having
+ glibc-2.1.
+ It installs a library `preloadable_libiconv.so'. This library can be used
+ with LD_PRELOAD, to override the iconv* functions present in the C library.
+
+ On GNU/Linux and Solaris:
+ $ export LD_PRELOAD=/usr/local/lib/preloadable_libiconv.so
+
+ On OSF/1:
+ $ export _RLD_LIST=/usr/local/lib/preloadable_libiconv.so:DEFAULT
+
+ A program's source need not be modified, the program need not even be
+ recompiled. Just set the LD_PRELOAD environment variable, that's it!
+
+
+Copyright
+---------
+
+The libiconv and libcharset _libraries_ and their header files are under LGPL,
+see file COPYING.LIB.
+
+The iconv _program_ and the documentation are under GPL, see file COPYING.
+
+
+Download
+--------
+
+ http://ftp.gnu.org/gnu/libiconv/libiconv-1.13.1.tar.gz
+
+Homepage
+--------
+
+ http://www.gnu.org/software/libiconv/
+
+Bug reports to
+--------------
+
+ <bug-gnu-libiconv@gnu.org>
+
+
+Bruno Haible <bruno@clisp.org>