Imported Upstream version 0.9.3
[platform/upstream/libunistring.git] / 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   uniwbrk.h    word breaks
15   unilbrk.h    line breaking algorithm
16   uninorm.h    normalization (composition and decomposition)
17   unicase.h    case folding
18   uniregex.h   regular expressions (not yet implemented)
19
20 libunistring is for you if your application involves non-trivial text
21 processing, such as upper/lower case conversions, line breaking, operations
22 on words, or more advanced analysis of text. Text provided by the user can,
23 in general, contain characters of all kinds of scripts. The text processing
24 functions provided by this library handle all scripts and all languages.
25
26 libunistring is for you if your application already uses the ISO C / POSIX
27 <ctype.h>, <wctype.h> functions and the text it operates on is provided by
28 the user and can be in any language.
29
30 libunistring is also for you if your application uses Unicode strings as
31 internal in-memory representation.
32
33
34 Installation
35 ------------
36
37 As usual for GNU packages:
38
39     $ ./configure --prefix=/usr/local
40     $ make
41     $ make install
42
43
44 Copyright
45 ---------
46
47 The libunistring library and its header files are under the GNU LGPL, see
48 file COPYING.LIB.  This license is based on the GNU GPL, see file COPYING.
49
50 The documentation is under another license; see in the documentation.
51
52
53 Download
54 --------
55
56     http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.3.tar.gz
57
58 Homepage
59 --------
60
61     http://www.gnu.org/software/libunistring/
62
63 Bug reports to
64 --------------
65
66     <bug-libunistring@gnu.org>
67
68
69 Bruno Haible <bruno@clisp.org>