Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv

libiconv 1.16

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