Name Date Size

..13-Jul-20204 KiB

.gitattributesH A D13-Aug-201732

.gitignoreH A D04-Apr-202010.3 KiB

.gitmodulesH A D26-Apr-201983

ABOUT-NLSH A D03-Jul-201967

AUTHORSH A D13-Aug-201731

autogen.shH A D05-Apr-20203.1 KiB

build-aux/H13-Aug-20174 KiB

ChangeLogH A D07-Aug-2020209 KiB

configure.acH A D04-Apr-20205.9 KiB

COPYINGH A D13-Aug-201734.3 KiB

COPYING.LIBH A D04-Apr-202025.9 KiB

DEPENDENCIESH A D13-Aug-201767

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 D05-Apr-20201.9 KiB

include/H04-Apr-20204 KiB

INSTALL.genericH A D04-May-201811.2 KiB

INSTALL.windowsH A D17-Sep-201810.1 KiB

lib/H07-Aug-20204 KiB

libcharset/H05-Apr-20204 KiB

m4/H13-Aug-20174 KiB

Makefile.develH A D05-Apr-20209.6 KiB

Makefile.inH A D27-Jan-201910.5 KiB

man/H27-Jan-20194 KiB

NEWSH A D04-Apr-20208.4 KiB

NOTESH A D13-Aug-201717.1 KiB

os2/H17-Sep-20184 KiB

po/H03-Jul-20194 KiB

READMEH A D11-May-20195 KiB

src/H11-May-20194 KiB

srclib/H03-Jul-20194 KiB

tests/H04-Apr-202012 KiB

THANKSH A D13-Aug-2017521

tools/H04-Apr-20204 KiB

windows/H04-Apr-20204 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
76It can convert from any of these encodings to any other, through Unicode
77conversion.
78
79It has also some limited support for transliteration, i.e. when a character
80cannot be represented in the target character set, it can be approximated
81through one or several similarly looking characters. Transliteration is
82activated when "//TRANSLIT" is appended to the target encoding name.
83
84libiconv is for you if your application needs to support multiple character
85encodings, but that support lacks from your system.
86
87
88Installation
89------------
90
91As usual for GNU packages:
92
93    $ ./configure --prefix=[[PREFIX]]     where [[PREFIX]] is e.g. $HOME/local
94    $ make
95    $ make install
96
97After installing GNU libiconv for the first time, it is recommended to
98recompile and reinstall GNU gettext, so that it can take advantage of
99libiconv.
100
101On systems other than GNU/Linux, the iconv program will be internationalized
102only if GNU gettext has been built and installed before GNU libiconv. This
103means that the first time GNU libiconv is installed, we have a circular
104dependency between the GNU libiconv and GNU gettext packages, which can be
105resolved by building and installing either
106  - first libiconv, then gettext, then libiconv again,
107or (on systems supporting shared libraries, excluding AIX)
108  - first gettext, then libiconv, then gettext again.
109Recall that before building a package for the second time, you need to erase
110the traces of the first build by running "make distclean".
111
112This library installs:
113  - a library 'libiconv.so',
114  - a header file '<iconv.h>'.
115
116To use it, simply #include <iconv.h> and use the functions.
117
118To use it in an autoconfiguring package:
119  - If you don't use automake, append m4/iconv.m4 to your aclocal.m4
120    file.
121  - If you do use automake, add m4/iconv.m4 to your m4 macro repository.
122  - Add to the link command line of libraries and executables that use
123    the functions the placeholder @LIBICONV@ (or, if using libtool for
124    the link, @LTLIBICONV@). If you use automake, the right place for
125    these additions are the *_LDADD variables.
126Note that 'iconv.m4' is also part of GNU gnulib, available through
127the gnulib module 'iconv'.
128
129
130Copyright
131---------
132
133The libiconv and libcharset _libraries_ and their header files are under LGPL,
134see file COPYING.LIB.
135
136The iconv _program_ and the documentation are under GPL, see file COPYING.
137
138
139Download
140--------
141
142    https://ftp.gnu.org/gnu/libiconv/libiconv-1.16.tar.gz
143
144Homepage
145--------
146
147    https://www.gnu.org/software/libiconv/
148
149Bug reports
150-----------
151
152Report bugs
153  - in the bug tracker at <https://savannah.gnu.org/projects/libiconv>
154  - or by email to <bug-gnu-libiconv@gnu.org>.
155
156
157Bruno Haible <bruno@clisp.org>
158