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: The Single Unix Specification (SUSV2)
  15 provides the nl_langinfo function, 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 config.charset. 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 sh-utils, fileutils, textutils
  44   GNU gettext
  45   GNU clisp
  46
  47
  48 To integrate this library into your package:
  49 See file INTEGRATE.
  50
  51
  52 Distribution:
  53     ftp://ftp.ilog.fr/pub/Users/haible/gnu/libcharset-1.0.tar.gz
  54
  55 Homepage:
  56     http://clisp.cons.org/~haible/packages-libcharset.html
  57
  58
  59 Bruno Haible <haible@clisp.cons.org>