1           GNU LIBUNISTRING - Unicode string library
2
3This library provides functions for manipulating Unicode strings and
4for manipulating C strings according to the Unicode standard.
5
6It 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
21libunistring is for you if your application involves non-trivial text
22processing, such as upper/lower case conversions, line breaking, operations
23on words, or more advanced analysis of text. Text provided by the user can,
24in general, contain characters of all kinds of scripts. The text processing
25functions provided by this library handle all scripts and all languages.
26
27libunistring 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
29the user and can be in any language.
30
31libunistring is also for you if your application uses Unicode strings as
32internal in-memory representation.
33
34
35Installation
36------------
37
38As usual for GNU packages:
39
40    $ ./configure --prefix=[[PREFIX]]     where [[PREFIX]] is e.g. $HOME/local
41    $ make
42    $ make install
43
44
45Copyright
46---------
47
48The libunistring library and its header files are dual-licensed under
49"the GNU LGPLv3+ or the GNU GPLv2". This means, you can use it under either
50  - the terms of the GNU Lesser General Public License (LGPL) version 3 or
51    (at your option) any later version, or
52  - the terms of the GNU General Public License (GPL) version 2, or
53  - the same dual license "the GNU LGPLv3+ or the GNU GPLv2".
54
55You find the GNU LGPL version 3 in the file COPYING.LIB.  This license is
56based on the GNU GPL version 3, see file COPYING.
57
58You can find the GNU GPL version 2 at
59<https://www.gnu.org/licenses/old-licenses/gpl-2.0.html>.
60
61Note: This dual license makes it possible for the libunistring library
62to be used by packages under GPLv2 or GPLv2+ licenses, in particular. See
63the table in <https://www.gnu.org/licenses/gpl-faq.html#AllCompatibility>.
64
65The documentation is under another license; see in the documentation.
66
67
68Download
69--------
70
71    https://ftp.gnu.org/gnu/libunistring/libunistring-0.9.10.tar.gz
72
73Homepage
74--------
75
76    https://www.gnu.org/software/libunistring/
77
78Bug reports to
79--------------
80
81    <bug-libunistring@gnu.org>
82
83
84Bruno Haible <bruno@clisp.org>
85