libcharset/README

   1           LIBCHARSET - portable character set determination library
   2
   3 This library provides a function which determines the character set / encoding
   4 of text in the currently selected locale (the LC_CTYPE locale facet).
   5
   6 It is useful for portable programs which need to process text in other
   7 encodings and locales than the currently selected one. Possible uses:
   8
   9   * Use of Unicode in POSIX compliant applications.
  10   * Conversion of text between the current locale's encoding and UTF-8 (or
  11     any other given encoding).
  12   * Mail agents.
  13
  14 In theory, this would be very simple: POSIX provides the nl_langinfo function,
  15 in such a way that
  16
  17                   nl_langinfo (CODESET)
  18
  19 returns the encoding name. But the nl_langinfo function still does not exist
  20 on some systems, and on those where it exists it returns unstandardized
  21 variations of the encoding names, like (on Solaris) "PCK" for "Shift_JIS".
  22
  23 This library fixes these flaws and provides a function
  24
  25        const char * locale_charset (void);
  26
  27 It determines the current locale's character encoding, and canonicalizes it
  28 into one of the canonical names listed in localcharset.h. The result must
  29 not be freed; it is statically allocated. If the canonical name cannot be
  30 determined, the result is a non-canonical name.
  31
  32
  33 Installation:
  34
  35 As usual for GNU packages:
  36
  37     $ ./configure --prefix=/usr/local
  38     $ make
  39     $ make install
  40
  41
  42 This library is used in
  43   GNU coreutils
  44   GNU gettext
  45   GNU clisp
  46
  47
  48 To integrate this library into your package:
  49 - Either from this package. See file INTEGRATE.
  50 - Or from gnulib. See
  51   <https://www.gnu.org/software/gnulib/MODULES.html#module=localcharset>
  52
  53
  54 Distribution:
  55     The libcharset directory of
  56     ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz
  57
  58 Homepage:
  59     https://haible.de/bruno/packages-libcharset.html
  60
  61
  62 Bruno Haible <bruno@clisp.org>