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.