*** empty log message ***
[m17n/m17n-pango.git] / README
1 This directory holds version 0.9.4 of pango-m17n.               -*- text -*-
2
3 Copyright (C) 2006, 2007, 2008
4   National Institute of Advanced Industrial Science and Technology (AIST)
5   Registration Number H16PRO276
6 See the end for copying conditions.
7
8 This package "pango-m17n" provides a single Pango shaping module for
9 various scripts that requires CTL (Complex Text Layout) language.  It
10 utilizes the rendering capability of the m17n library.
11
12
13 (1) INSTALLATION
14
15 (1-1) From CVS working directory.
16
17 Run the script "bootstrap.sh" in this directory.  It is tested that
18 the script run successfully with these versions of autotools.
19
20         libtool-1.5.22
21         automake-1.9.6
22         autoconf-2.60
23
24 Then, proceed to the next step.
25
26 (1-2) From the tarball.
27
28 It requires Pango (ver.1.6 or the later) and the m17n library
29 (ver.1.5.1 or the later).
30
31 Type the followings on the command line.
32
33         % ./configure
34         % make
35         % make install
36
37 The default installation path is "/usr/local".
38
39 Please read also INSTALL for the generic installation instructions.
40
41
42 (2) USAGE
43
44 To use this pango module (shaper engine), you have to set two
45 environment variables as this:
46
47 % export PANGO_RC_FILE=/usr/local/lib/pango-m17n/pangorc.m17n
48 % export PANGO_USE_M17N=1
49
50 You can also set various MDEBUG_XXX environment variables (handled by
51 the m17n library) to check what is going on.  For instance, when you
52 run gedit as this:
53
54 % MDEBUG_FLT=1 gedit SOME_FILE
55
56 you'll see the debugging information about how Complex Text Layouting
57 is working (if SOME_FILE contains, for instance, Indic text).
58
59 ----------------------------------------------------------------------
60 Copyright information
61
62 Copyright (C) 2006, 2007, 2008
63   National Institute of Advanced Industrial Science and Technology (AIST)
64   Registration Number H16PRO276
65
66 This file is part of pango-m17n library.
67
68 The pango-m17n library is free software; you can redistribute it
69 and/or modify it under the terms of the GNU Lesser General Public
70 License as published by the Free Software Foundation; either version
71 2.1 of the License, or (at your option) any later version.
72
73 The pango-m17n library is distributed in the hope that it will be
74 useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
75 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
76 Lesser General Public License for more details.
77
78 You should have received a copy of the GNU Lesser General Public
79 License along with the pango-m17n library; if not, write to the Free
80 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
81 02111-1307, USA.