--- embedaddon/libiconv/README 2012/05/29 09:29:42 1.1.1.2 +++ embedaddon/libiconv/README 2021/03/17 13:38:46 1.1.1.3 @@ -15,7 +15,8 @@ It provides support for the encodings: 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 + EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1, + ISO-2022-JP-MS Chinese EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS, BIG5-HKSCS:2004, BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN, @@ -46,10 +47,10 @@ It provides support for the encodings: UTF-32, UTF-32BE, UTF-32LE UTF-7 C99, JAVA - Full Unicode, in terms of `uint16_t' or `uint32_t' + 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' + 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 @@ -89,7 +90,7 @@ Installation As usual for GNU packages: - $ ./configure --prefix=/usr/local + $ ./configure --prefix=[[PREFIX]] where [[PREFIX]] is e.g. $HOME/local $ make $ make install @@ -108,41 +109,24 @@ or (on systems supporting shared libraries, excluding 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: +This library installs: + - a library 'libiconv.so', + - a header file ''. - - The library mode. This works on all systems, and uses a library - `libiconv.so' and a header file `'. (Both are installed - through "make install".) +To use it, simply #include and use the functions. - To use it, simply #include 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 GNU gnulib, available through +the gnulib module 'iconv'. - 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 --------- @@ -155,12 +139,12 @@ The iconv _program_ and the documentation are under GP Download -------- - http://ftp.gnu.org/gnu/libiconv/libiconv-1.14.tar.gz + https://ftp.gnu.org/gnu/libiconv/libiconv-1.16.tar.gz Homepage -------- - http://www.gnu.org/software/libiconv/ + https://www.gnu.org/software/libiconv/ Bug reports to --------------