Name Date Size

..27-Apr.-20224 KiB

.gitattributesH A D13-Aug.-201732

.gitignoreH A D12-Feb.-202211.6 KiB

.gitmodulesH A D26-Apr.-201983

ABOUT-NLSH A D03-Jul.-201967

AUTHORSH A D13-Aug.-201731

autogen.shH A D16-Feb.-20213.1 KiB

build-aux/H15-May-20224 KiB

ChangeLogH A D15-May-2022215.9 KiB

configure.acH A D12-Feb.-20225.9 KiB

COPYINGH A D13-Aug.-201734.3 KiB

COPYING.LIBH A D04-Apr.-202025.9 KiB

DEPENDENCIESH A D28-Feb.-20212 KiB

DESIGNH A D13-Aug.-20173.3 KiB

extras/H13-Aug.-20174 KiB

gitsub.shH A D01-Sep.-201916.5 KiB

gnulib-local/H13-Aug.-20174 KiB

HACKINGH A D09-Dec.-20201.8 KiB

include/H12-Feb.-20224 KiB

INSTALL.genericH A D04-May-201811.2 KiB

INSTALL.windowsH A D17-Sep.-201810.1 KiB

lib/H12-Feb.-202212 KiB

libcharset/H15-May-20224 KiB

m4/H15-May-20224 KiB

Makefile.develH A D24-Jan.-20229.8 KiB

Makefile.inH A D16-Feb.-202110.5 KiB

man/H24-Jan.-20224 KiB

NEWSH A D07-Feb.-20228.8 KiB

NOTESH A D24-Jan.-202217.2 KiB

os2/H17-Sep.-20184 KiB

po/H15-May-20224 KiB

READMEH A D12-Feb.-20225.5 KiB

src/H12-Feb.-20224 KiB

srclib/H03-Jul.-20194 KiB

tests/H15-May-202212 KiB

THANKSH A D13-Aug.-2017521

tools/H24-Jan.-20224 KiB

windows/H12-Feb.-20224 KiB

woe32dll/H04-Apr.-20204 KiB

README

1            GNU LIBICONV - character set conversion library
2
3This library provides an iconv() implementation, for use on systems which
4don't have one, or whose implementation cannot convert from/to Unicode.
5
6It provides support for the encodings:
7
8    European languages
9        ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
10        KOI8-R, KOI8-U, KOI8-RU,
11        CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
12        Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
13        Mac{Cyrillic,Ukraine,Greek,Turkish},
14        Macintosh
15    Semitic languages
16        ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
17    Japanese
18        EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1,
19        ISO-2022-JP-MS
20    Chinese
21        EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS,
22        BIG5-HKSCS:2004, BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN,
23        ISO-2022-CN-EXT
24    Korean
25        EUC-KR, CP949, ISO-2022-KR, JOHAB
26    Armenian
27        ARMSCII-8
28    Georgian
29        Georgian-Academy, Georgian-PS
30    Tajik
31        KOI8-T
32    Kazakh
33        PT154, RK1048
34    Thai
35        ISO-8859-11, TIS-620, CP874, MacThai
36    Laotian
37        MuleLao-1, CP1133
38    Vietnamese
39        VISCII, TCVN, CP1258
40    Platform specifics
41        HP-ROMAN8, NEXTSTEP
42    Full Unicode
43        UTF-8
44        UCS-2, UCS-2BE, UCS-2LE
45        UCS-4, UCS-4BE, UCS-4LE
46        UTF-16, UTF-16BE, UTF-16LE
47        UTF-32, UTF-32BE, UTF-32LE
48        UTF-7
49        C99, JAVA
50    Full Unicode, in terms of 'uint16_t' or 'uint32_t'
51        (with machine dependent endianness and alignment)
52        UCS-2-INTERNAL, UCS-4-INTERNAL
53    Locale dependent, in terms of 'char' or 'wchar_t'
54        (with machine dependent endianness and alignment, and with OS and
55        locale dependent semantics)
56        char, wchar_t
57        The empty encoding name "" is equivalent to "char": it denotes the
58        locale dependent character encoding.
59
60When configured with the option --enable-extra-encodings, it also provides
61support for a few extra encodings:
62
63    European languages
64        CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
65    Semitic languages
66        CP864
67    Japanese
68        EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
69    Chinese
70        BIG5-2003 (experimental)
71    Turkmen
72        TDS565
73    Platform specifics
74        ATARIST, RISCOS-LATIN1
75    EBCDIC compatible (not ASCII compatible, very rarely used)
76        European languages
77            IBM-{037,273,277,278,280,282,284,285,297,423,500,870,871,875,880},
78            IBM-{905,924,1025,1026,1047,1112,1122,1123,1140,1141,1142,1143},
79            IBM-{1144,1145,1146,1147,1148,1149,1153,1154,1155,1156,1157,1158},
80            IBM-{1165,1166,4971}
81        Semitic languages
82            IBM-{424,425,12712,16804}
83        Persian
84            IBM-1097
85        Thai
86            IBM-{838,1160}
87        Laotian
88            IBM-1132
89        Vietnamese
90            IBM-{1130,1164}
91        Indic languages
92            IBM-1137
93
94It can convert from any of these encodings to any other, through Unicode
95conversion.
96
97It has also some limited support for transliteration, i.e. when a character
98cannot be represented in the target character set, it can be approximated
99through one or several similarly looking characters. Transliteration is
100activated when "//TRANSLIT" is appended to the target encoding name.
101
102libiconv is for you if your application needs to support multiple character
103encodings, but that support lacks from your system.
104
105
106Installation
107------------
108
109As usual for GNU packages:
110
111    $ ./configure --prefix=[[PREFIX]]     where [[PREFIX]] is e.g. $HOME/local
112    $ make
113    $ make install
114
115After installing GNU libiconv for the first time, it is recommended to
116recompile and reinstall GNU gettext, so that it can take advantage of
117libiconv.
118
119On systems other than GNU/Linux, the iconv program will be internationalized
120only if GNU gettext has been built and installed before GNU libiconv. This
121means that the first time GNU libiconv is installed, we have a circular
122dependency between the GNU libiconv and GNU gettext packages, which can be
123resolved by building and installing either
124  - first libiconv, then gettext, then libiconv again,
125or (on systems supporting shared libraries, excluding AIX)
126  - first gettext, then libiconv, then gettext again.
127Recall that before building a package for the second time, you need to erase
128the traces of the first build by running "make distclean".
129
130This library installs:
131  - a library 'libiconv.so',
132  - a header file '<iconv.h>'.
133
134To use it, simply #include <iconv.h> and use the functions.
135
136To use it in a package that uses GNU autoconf and GNU automake:
137  - Use gnulib-tool to import the Gnulib module 'iconv'. It consists
138    of a couple of *.m4 files (iconv.m4 and its dependencies) and a
139    file 'build-aux/config.rpath'.
140  - Add to the link command line of libraries and executables that use
141    the functions the placeholder @LIBICONV@ (or, if using libtool for
142    the link, @LTLIBICONV@). In Makefile.am files, the right place for
143    these additions are the *_LDADD variables.
144
145
146Copyright
147---------
148
149The libiconv and libcharset _libraries_ and their header files are under LGPL,
150see file COPYING.LIB.
151
152The iconv _program_ and the documentation are under GPL, see file COPYING.
153
154
155Download
156--------
157
158    https://ftp.gnu.org/gnu/libiconv/libiconv-1.17.tar.gz
159
160Homepage
161--------
162
163    https://www.gnu.org/software/libiconv/
164
165Bug reports
166-----------
167
168Report bugs
169  - in the bug tracker at <https://savannah.gnu.org/projects/libiconv>
170  - or by email to <bug-gnu-libiconv@gnu.org>.
171
172
173Bruno Haible <bruno@clisp.org>
174