Name | Date | Size | ||
---|---|---|---|---|
.. | 16-May-2017 | 37 | ||
ABOUT-NLS | H A D | 18-Jul-2016 | 65.9 KiB | |
aclocal.m4 | H A D | 18-Jul-2016 | 31.3 KiB | |
AUTHORS | H A D | 18-Jul-2016 | 31 | |
build-aux/ | H | 16-May-2017 | 12 | |
ChangeLog | H A D | 18-Jul-2016 | 122.5 KiB | |
config.h | H A D | 18-Jul-2016 | 8.7 KiB | |
config.h.in | H A D | 18-Jul-2016 | 8.3 KiB | |
config.h.msvc | H A D | 18-Jul-2016 | 8.3 KiB | |
config.h_vms | H A D | 18-Jul-2016 | 8.4 KiB | |
config.log | H A D | 18-Jul-2016 | 142.2 KiB | |
config.status | H A D | 18-Jul-2016 | 54.7 KiB | |
configure | H A D | 18-Jul-2016 | 917.5 KiB | |
configure.in | H A D | 18-Jul-2016 | 3.6 KiB | |
COPYING.LIB | H A D | 18-Jul-2016 | 24.7 KiB | |
DESIGN | H A D | 18-Jul-2016 | 3.3 KiB | |
djgpp/ | H | 16-May-2017 | 16 | |
extras/ | H | 16-May-2017 | 5 | |
include/ | H | 16-May-2017 | 7 | |
INSTALL.generic | H A D | 18-Jul-2016 | 10.4 KiB | |
lib/ | H | 16-May-2017 | 214 | |
libcharset/ | H | 16-May-2017 | 33 | |
libtool | H A D | 18-Jul-2016 | 209.6 KiB | |
m4/ | H | 16-May-2017 | 48 | |
Makefile | H A D | 18-Jul-2016 | 6 KiB | |
Makefile.devel | H A D | 18-Jul-2016 | 10.3 KiB | |
Makefile.in | H A D | 18-Jul-2016 | 6 KiB | |
Makefile.msvc | H A D | 18-Jul-2016 | 5.8 KiB | |
Makefile.vms | H A D | 18-Jul-2016 | 7.4 KiB | |
man/ | H | 16-May-2017 | 16 | |
NEWS | H A D | 18-Jul-2016 | 5.3 KiB | |
NOTES | H A D | 18-Jul-2016 | 16.8 KiB | |
os2/ | H | 16-May-2017 | 3 | |
po/ | H | 16-May-2017 | 86 | |
PORTS | H A D | 18-Jul-2016 | 461 | |
README | H A D | 18-Jul-2016 | 5.3 KiB | |
README.djgpp | H A D | 18-Jul-2016 | 51 | |
README.woe32 | H A D | 18-Jul-2016 | 4.8 KiB | |
src/ | H | 16-May-2017 | 8 | |
srclib/ | H | 16-May-2017 | 44 | |
stamp-h1 | H A D | 18-Jul-2016 | 23 | |
tests/ | H | 16-May-2017 | 187 | |
THANKS | H A D | 18-Jul-2016 | 439 | |
tools/ | H | 16-May-2017 | 7 | |
vms/ | H | 18-Jul-2016 | 2 | |
windows/ | H | 16-May-2017 | 6 |
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, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS, 21 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.10.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.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