README

   1            GNU LIBUNISTRING - Unicode string library
   2
   3 This library provides functions for manipulating Unicode strings and
   4 for manipulating C strings according to the Unicode standard.
   5
   6 It consists of the following parts:
   7
   8   unistr.h     elementary string functions
   9   uniconv.h    conversion from/to legacy encodings
  10   unistdio.h   formatted output to strings
  11   uniname.h    character names
  12   unictype.h   character classification and properties
  13   uniwidth.h   string width when using nonproportional fonts
  14   unigbrk.h    grapheme cluster breaks
  15   uniwbrk.h    word breaks
  16   unilbrk.h    line breaking algorithm
  17   uninorm.h    normalization (composition and decomposition)
  18   unicase.h    case folding
  19   uniregex.h   regular expressions (not yet implemented)
  20
  21 libunistring is for you if your application involves non-trivial text
  22 processing, such as upper/lower case conversions, line breaking, operations
  23 on words, or more advanced analysis of text. Text provided by the user can,
  24 in general, contain characters of all kinds of scripts. The text processing
  25 functions provided by this library handle all scripts and all languages.
  26
  27 libunistring is for you if your application already uses the ISO C / POSIX
  28 <ctype.h>, <wctype.h> functions and the text it operates on is provided by
  29 the user and can be in any language.
  30
  31 libunistring is also for you if your application uses Unicode strings as
  32 internal in-memory representation.
  33
  34
  35 Installation
  36 ------------
  37
  38 As usual for GNU packages:
  39
  40     $ ./configure --prefix=/usr/local
  41     $ make
  42     $ make install
  43
  44
  45 Copyright
  46 ---------
  47
  48 The libunistring library and its header files are under the GNU LGPL, see
  49 file COPYING.LIB.  This license is based on the GNU GPL, see file COPYING.
  50
  51 The documentation is under another license; see in the documentation.
  52
  53
  54 Download
  55 --------
  56
  57     http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.4.tar.gz
  58
  59 Homepage
  60 --------
  61
  62     http://www.gnu.org/software/libunistring/
  63
  64 Bug reports to
  65 --------------
  66
  67     <bug-libunistring@gnu.org>
  68
  69
  70 Bruno Haible <bruno@clisp.org>