Return to README CVS log

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

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

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: 
1.1.1.2   misho      14: In theory, this would be very simple: POSIX provides the nl_langinfo function,
                     15: in such a way that
1.1       misho      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
1.1.1.3 ! misho      28: into one of the canonical names listed in localcharset.h. The result must
1.1       misho      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
1.1.1.2   misho      43:   GNU coreutils
1.1       misho      44:   GNU gettext
                     45:   GNU clisp
                     46: 
                     47: 
                     48: To integrate this library into your package:
1.1.1.2   misho      49: - Either from this package. See file INTEGRATE.
                     50: - Or from gnulib. See
1.1.1.3 ! misho      51:   <https://www.gnu.org/software/gnulib/MODULES.html#module=localcharset>
1.1       misho      52: 
                     53: 
                     54: Distribution:
                     55:     The libcharset directory of
1.1.1.3 ! misho      56:     ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz
1.1       misho      57: 
                     58: Homepage:
1.1.1.3 ! misho      59:     https://haible.de/bruno/packages-libcharset.html
1.1       misho      60: 
                     61: 
                     62: Bruno Haible <bruno@clisp.org>