Return to README CVS log

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

Annotation of embedaddon/libiconv/libcharset/README, revision 1.1.1.1

1.1       misho       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:     The libcharset directory of
                     54:     ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.8.tar.gz
                     55: 
                     56: Homepage:
                     57:     http://www.haible.de/bruno/packages-libcharset.html
                     58: 
                     59: 
                     60: Bruno Haible <bruno@clisp.org>