README
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 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
20libunistring is for you if your application involves non-trivial text
21processing, such as upper/lower case conversions, line breaking, operations
22on words, or more advanced analysis of text. Text provided by the user can,
23in general, contain characters of all kinds of scripts. The text processing
24functions provided by this library handle all scripts and all languages.
25
26libunistring 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
28the user and can be in any language.
29
30libunistring is also for you if your application uses Unicode strings as
31internal in-memory representation.
32
33
34Installation
35------------
36
37As usual for GNU packages:
38
39 $ ./configure --prefix=/usr/local
40 $ make
41 $ make install
42
43
44Copyright
45---------
46
47The libunistring library and its header files are under the GNU LGPL, see
48file COPYING.LIB. This license is based on the GNU GPL, see file COPYING.
49
50The documentation is under another license; see in the documentation.
51
52
53Download
54--------
55
56 http://ftp.gnu.org/gnu/libunistring/libunistring-0.9.3.tar.gz
57
58Homepage
59--------
60
61 http://www.gnu.org/software/libunistring/
62
63Bug reports to
64--------------
65
66 <bug-libunistring@gnu.org>
67
68
69Bruno Haible <bruno@clisp.org>
70
README.woe32
1Installation on Woe32 (WinNT/2000/XP/Vista/7, Win95/98/ME):
2
3This file explains how to create binaries for the mingw execution environment.
4For how to create binaries for the cygwin environment, please see the normal
5INSTALL file. MS Visual C/C++ with "nmake" is no longer supported.
6
7I recommend to use the cygwin environment as the development environment
8and mingw only as the target (runtime, deployment) environment.
9For this, you need to install
10 - cygwin,
11 - the mingw runtime package, also from the cygwin site.
12
13You must not install cygwin programs directly under /usr/local -
14because the mingw compiler and linker would pick up the include files
15and libraries from there, thus introducing an undesired dependency to
16cygwin. You can for example achieve this by using the
17configure option --prefix=/usr/local/cygwin each time you build a
18program for cygwin.
19
20Building for mingw is then achieved through the following preparation
21and configure commands:
22
23 PATH=/usr/local/mingw/bin:$PATH
24 export PATH
25 ./configure --host=i586-pc-mingw32 --prefix=/usr/local/mingw \
26 CC="gcc-3 -mno-cygwin" \
27 CXX="g++-3 -mno-cygwin" \
28 CPPFLAGS="-Wall -I/usr/local/mingw/include" \
29 LDFLAGS="-L/usr/local/mingw/lib"
30
31The -mno-cygwin tells the cygwin compiler and linker to build for mingw.
32The -I and -L option are so that packages previously built for the
33same environment are found. The --host option tells the various
34tools that you are building for mingw, not cygwin.
35
36Dependencies:
37
38This package depends on GNU libiconv. (See the file DEPENDENCIES.) Before
39building this package, you need to build GNU libiconv, in the same development
40environment, with the same configure options, and install it ("make install").
41