• Home
  • History
  • Annotate
  • only in this directory
NameDateSize

..10-May-20138

ABOUT-NLSH A D23-Jul-200965.9 KiB

aclocal.m4H A D23-Jul-200931.5 KiB

AUTHORSH A D23-Jul-200931

build-aux/H10-May-201312

ChangeLogH A D23-Jul-2009143.2 KiB

config.hH A D03-Sep-200920.8 KiB

config.h.inH A D23-Jul-200919.4 KiB

config.h.msvcH A D23-Jul-200919.4 KiB

config.h_vmsH A D23-Jul-200919.5 KiB

configureH A D23-Jul-20091.2 MiB

configure.acH A D23-Jul-20095.2 KiB

COPYING.LIBH A D23-Jul-200924.7 KiB

DESIGNH A D23-Jul-20093.3 KiB

djgpp/H10-May-201316

extras/H10-May-20135

include/H10-May-20139

INSTALL.genericH A D23-Jul-200910.4 KiB

lib/H10-May-2013222

libcharset/H10-May-201329

m4/H10-May-201354

Makefile.develH A D23-Jul-200910.8 KiB

Makefile.inH A D23-Jul-20096.3 KiB

Makefile.msvcH A D23-Jul-20095.8 KiB

Makefile.os2H A D23-Jul-20093.3 KiB

Makefile.vmsH A D23-Jul-20097.4 KiB

man/H10-May-201316

NEWSH A D23-Jul-20096.4 KiB

NOTESH A D23-Jul-200916.8 KiB

os2/H10-May-20133

po/H10-May-201385

PORTSH A D23-Jul-2009461

READMEH A D23-Jul-20095.4 KiB

README.djgppH A D23-Jul-200951

README.os2H A D23-Jul-20091.5 KiB

README.woe32H A D23-Jul-20094.8 KiB

src/H10-May-20138

srclib/H10-May-201342

tests/H10-May-2013201

THANKSH A D23-Jul-2009521

tools/H10-May-20137

vms/H10-May-20133

windows/H10-May-20136

woe32dll/H10-May-20134

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},
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    Chinese
20        EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS,
21        BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN, ISO-2022-CN-EXT
22    Korean
23        EUC-KR, CP949, ISO-2022-KR, JOHAB
24    Armenian
25        ARMSCII-8
26    Georgian
27        Georgian-Academy, Georgian-PS
28    Tajik
29        KOI8-T
30    Kazakh
31        PT154
32    Thai
33        ISO-8859-11, TIS-620, CP874, MacThai
34    Laotian
35        MuleLao-1, CP1133
36    Vietnamese
37        VISCII, TCVN, CP1258
38    Platform specifics
39        HP-ROMAN8, NEXTSTEP
40    Full Unicode
41        UTF-8
42        UCS-2, UCS-2BE, UCS-2LE
43        UCS-4, UCS-4BE, UCS-4LE
44        UTF-16, UTF-16BE, UTF-16LE
45        UTF-32, UTF-32BE, UTF-32LE
46        UTF-7
47        C99, JAVA
48    Full Unicode, in terms of `uint16_t' or `uint32_t'
49        (with machine dependent endianness and alignment)
50        UCS-2-INTERNAL, UCS-4-INTERNAL
51    Locale dependent, in terms of `char' or `wchar_t'
52        (with machine dependent endianness and alignment, and with OS and
53        locale dependent semantics)
54        char, wchar_t
55        The empty encoding name "" is equivalent to "char": it denotes the
56        locale dependent character encoding.
57
58When configured with the option --enable-extra-encodings, it also provides
59support for a few extra encodings:
60
61    European languages
62        CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
63    Semitic languages
64        CP864
65    Japanese
66        EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
67    Chinese
68        BIG5-2003 (experimental)
69    Turkmen
70        TDS565
71    Platform specifics
72        ATARIST, RISCOS-LATIN1
73
74It can convert from any of these encodings to any other, through Unicode
75conversion.
76
77It has also some limited support for transliteration, i.e. when a character
78cannot be represented in the target character set, it can be approximated
79through one or several similarly looking characters. Transliteration is
80activated when "//TRANSLIT" is appended to the target encoding name.
81
82libiconv is for you if your application needs to support multiple character
83encodings, but that support lacks from your system.
84
85Installation:
86
87As usual for GNU packages:
88
89    $ ./configure --prefix=/usr/local
90    $ make
91    $ make install
92
93After installing GNU libiconv for the first time, it is recommended to
94recompile and reinstall GNU gettext, so that it can take advantage of
95libiconv.
96
97On systems other than GNU/Linux, the iconv program will be internationalized
98only if GNU gettext has been built and installed before GNU libiconv. This
99means that the first time GNU libiconv is installed, we have a circular
100dependency between the GNU libiconv and GNU gettext packages, which can be
101resolved by building and installing either
102  - first libiconv, then gettext, then libiconv again,
103or (on systems supporting shared libraries, excluding AIX)
104  - first gettext, then libiconv, then gettext again.
105Recall that before building a package for the second time, you need to erase
106the traces of the first build by running "make distclean".
107
108This library can be built and installed in two variants:
109
110  - The library mode. This works on all systems, and uses a library
111    `libiconv.so' and a header file `<iconv.h>'. (Both are installed
112    through "make install".)
113
114    To use it, simply #include <iconv.h> and use the functions.
115
116    To use it in an autoconfiguring package:
117    - If you don't use automake, append m4/iconv.m4 to your aclocal.m4
118      file.
119    - If you do use automake, add m4/iconv.m4 to your m4 macro repository.
120    - Add to the link command line of libraries and executables that use
121      the functions the placeholder @LIBICONV@ (or, if using libtool for
122      the link, @LTLIBICONV@). If you use automake, the right place for
123      these additions are the *_LDADD variables.
124    Note that 'iconv.m4' is also part of the GNU gettext package, which
125    installs it in /usr/local/share/aclocal/iconv.m4.
126
127  - The libc plug/override mode. This works on GNU/Linux, Solaris and OSF/1
128    systems only. It is a way to get good iconv support without having
129    glibc-2.1.
130    It installs a library `preloadable_libiconv.so'. This library can be used
131    with LD_PRELOAD, to override the iconv* functions present in the C library.
132
133    On GNU/Linux and Solaris:
134        $ export LD_PRELOAD=/usr/local/lib/preloadable_libiconv.so
135
136    On OSF/1:
137        $ export _RLD_LIST=/usr/local/lib/preloadable_libiconv.so:DEFAULT
138
139    A program's source need not be modified, the program need not even be
140    recompiled. Just set the LD_PRELOAD environment variable, that's it!
141
142
143Download:
144    ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.11.tar.gz
145
146Homepage:
147    http://www.gnu.org/software/libiconv/
148
149Bug reports to:
150    <bug-gnu-libiconv@gnu.org>
151
152
153Bruno Haible <bruno@clisp.org>
154

README.djgpp

1Installation on DJGPP:
2
3See the file djgpp/README.
4

README.os2

1Installation on OS/2:
2
3- Port done by Akira Hatakeyama <akira@sra.co.jp>, see
4  http://www.sra.co.jp/people/akira/os2/libiconv/index.html
5
6- Requires emx+gcc, recommend emx-0.9d with fix03 or newer.
7
8  Also requires a few GNU utilities to be installed: GNU fileutils (cp, mv,
9  rm, ...), GNU textutils (cat, cmp, uniq, ...), GNU sed, GNU make.
10
11- Cannot build in a separate directory.
12
13- Build instructions:
14
15  No configure script needs to be run. Just
16
17       make -f Makefile.os2 all
18
19  Checking it:
20
21       make -f Makefile.os2 check
22
23- Installation:
24
25       make -f Makefile.os2 install prefix="X:/emx"
26
27  The prefix option specifies where you have EMX installed and wish the
28  iconv library and headers to be installed.
29
30  This will install
31   * an include file                                  $(prefix)/include/iconv.h
32   * a DLL                                            $(prefix)/dll/iconv.dll
33   * an import library for .o (use without "-Zomf")   $(prefix)/lib/iconv.a
34   * an import library for .obj (use with "-Zomf")    $(prefix)/lib/iconv.lib
35   * a few manual pages                            $(prefix)/man/man3/iconv*.3
36
37- Use:
38
39  Your main program should include <iconv.h> when using the iconv* functions.
40
41  If you compile as .o (no "-Zomf"), link with iconv.a.
42  If you compile as .obj (with "-Zomf"), link with iconv.lib.
43
44  The DLL was built with "-Zmt -Zcrtdll" options. So your main program must
45  be built with "-Zmt -Zcrtdll" as well (or the shorthand "-Zmtd").
46
47

README.woe32

1Installation on Woe32 (WinNT/2000/XP, Win95/98/ME):
2
3- Requires MS Visual C/C++ 4.0 or 5.0 or 6.0 or 7.0.
4
5  Note that binaries created with MSVC 7.0 should not be distributed: They
6  depend on a closed-source library 'msvcr70.dll' which is not normally part
7  of a Woe32 installation. You cannot distribute 'msvcr70.dll' with the
8  binaries - this would be a violation of the GPL and of the Microsoft EULA.
9  You can distribute the binaries without including 'msvcr70.dll', but this
10  will cause problems for users that don't have this library on their system.
11  Therefore it is not recommended. This problem does not occur with MSVC 6.0
12  and earlier.
13
14- Cannot build in a separate directory.
15
16- Build instructions:
17
18   Make sure that the MSVC4.0 or MSVC5.0 or MSVC6.0 or MSVC7.0 utilities
19   ("cl" etc.) are found in PATH. In a typical MSVC6.0 installation, this
20   can be achieved by running
21        C:\Program Files\Microsoft Visual Studio\VC98\bin\vcvars32.bat
22   In a typical MSVC7.0 installation, it can be achieved by running
23        C:\Program Files\Microsoft Visual Studio .NET\Common7\Tools\vsvars32.bat
24
25   Decide which compilation model you will use:
26     MFLAGS=-ML (the default)  Single-threaded, statically linked - libc.lib
27     MFLAGS=-MT                Multi-threaded, statically linked  - libcmt.lib
28     MFLAGS=-MD                Multi-threaded, dynamically linked - msvcrt.lib
29
30   Step 1: Build and install the libiconv library and the iconv.exe program
31   without internationalization. (This step is only needed the first time
32   you install GNU libiconv.)
33
34      For shared library (DLL):
35
36         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD
37      or
38         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD check
39                                                   [This runs the testsuite.]
40
41      For static library:
42
43         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD
44      or
45         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD check
46                                                   [This runs the testsuite.]
47
48      If you want to build both the shared and static library, you have to
49      unpack the libiconv sources twice in different directories. Don't mix
50      the two formats; you cannot use the iconv.h generated for the static
51      library together with the shared library or vice versa.
52
53      Install it:
54
55         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD install
56      or
57         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD install
58
59      Remove traces of this preliminary build:
60
61         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD distclean
62      or
63         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD distclean
64
65   Step 2: Build and install the GNU gettext package (version 0.12 or newer,
66   libintl library and various programs) using the same MFLAGS. Then come
67   back to here, to build GNU libiconv. (This step is only needed if you
68   haven't GNU gettext already installed.)
69
70   Step 3: Build and install the libiconv library and the iconv.exe program
71   with internationalization.
72
73      For shared library (DLL):
74
75         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD
76      or
77         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD check
78                                                    [This runs the testsuite.]
79
80      For static library:
81
82         nmake -f Makefile.msvc MFLAGS=-MD
83      or
84         nmake -f Makefile.msvc MFLAGS=-MD check    [This runs the testsuite.]
85
86      If you want to build both the shared and static library, you have to
87      unpack the libiconv sources twice in different directories. Don't mix
88      the two formats; you cannot use the iconv.h generated for the static
89      library together with the shared library or vice versa.
90
91      Install it:
92
93         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD install
94      or
95         nmake -f Makefile.msvc MFLAGS=-MD install
96
97- Installation:
98
99   Manual minimal installation:
100
101      Copy include/iconv.h to your header file repository.
102      Copy lib/iconv.lib to your library repository.
103      If you built for shared library, also copy lib/iconv.dll into one of
104      the directories listed in your PATH, or into the directory containing
105      the executable which shall make use of libiconv.
106
107   Complete and automatic installation:
108
109         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD install PREFIX=InstallBaseDirectory
110      or
111         nmake -f Makefile.msvc MFLAGS=-MD install PREFIX=InstallBaseDirectory
112
113      By default, the compiled package is installed under c:\usr. You can
114      specify a different directory by giving the installation base directory
115      in a PREFIX=... option in the install step. (DON'T give the PREFIX
116      already in the build step! This won't work.) You can also omit the
117      PREFIX=... option, thus installing everything under c:\usr, and then
118      move the installed package as a whole from c:\usr to a different
119      location.
120