-This directory tree holds version 1.2.0 of the m17n library. -*- text -*-
+This directory tree holds version 1.5.2 of the m17n library. -*- text -*-
-Copyright (C) 2003, 2004
+Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008
National Institute of Advanced Industrial Science and Technology (AIST)
Registration Number H15PRO112
See the end for copying conditions.
The m17n library is a multilingual text processing library for the C
language.
+
(1) INSTALLATION
(1-1) From CVS working directory.
Run the script "bootstrap.sh" in this directory. It is tested that
the script run successfully with these versions of autotools.
- libtool-1.4
- automake-1.4p5
- autoconf-2.52
+ libtool-1.5.22
+ automake-1.9.6
+ autoconf-2.61
Then, proceed to the next step.
libotf -- http://www.m17n.org/libotf/
fontconfig -- http://freedesktop.org/Software/fontconfig
xft -- http://freedesktop.org/Software/Xft
- gd -- http://www.boutell.com/gd/http/gd-1.8.4.tar.gz
+ gd -- http://www.boutell.com/gd/
+
+In addition, for finding a word boundary in Thai text, "configure"
+checks the existence of these libraries (libthai is preferred):
+
+ libthai -- http://sourceforge.net/projects/libthai
+ wordcut -- http://thaiwordseg.sourceforge.net/
The sample program m17n-edit utilizes this Japanese inputting system.
It is also recommended to install it.
anthy -- http://anthy.sourceforge.jp/
-The sample program m17n-edit and mdump utilize this Thai word-boundary
-finder. It is also recommended to install it.
-
- wordcut -- http://thaiwordseg.sourceforge.net/
-
Then, type the followings on the command line.
% ./configure
The default installation path is "/usr/local".
Thus, these header files are installed in /usr/local/include:
- m17n-core.h, m17n.h, m17n-gui.h, m17n-err.h, m17n-X.h
+ m17n-core.h, m17n.h, m17n-gui.h, m17n-err.h, m17n-X.h, m17n-flt.h
+
These library files are installed in /usr/local/lib:
libm17n-core.{a,so*,la}
libm17n.{a,so*,la}
libm17n-gui.{a,so*,la}
libm17n-X.{a,so*,la}
libm17n-gd.{a,so*,la}
+ libm17n-flt.{a,so*,la}
libimx-anthy.{a,so*,la},
libimx-ispell.{a,so*,la},
+
This shell script is installed in /usr/local/bin:
m17n-config
+
+These pkgconfig metadata files are installed in
+/usr/local/lib/pkgconfig:
+ m17n-core.pc, m17n-shell.pc, m17n-flt.pc, m17n-gui.pc
+
These sample programs are installed in /usr/local/bin too:
m17n-conv, m17n-date, m17n-view, m17n-dump, m17n-edit
+If you don't need GUI libraries (libm17n-gui.so and etc.), you can
+instruct the `configure' script not to build them as below:
+
+ % ./configure --without-gui
+
This file under `example' sub-directory is a Japanese resource file
-for medit. It is not installed but useful in Japanese locale. Copy
+for m17n-edit. It is not installed but useful in Japanese locale. Copy
it to your home directory (or, for instance,
/usr/X11R6/lib/X11/ja/app-defaults) and rename it to "M17NEdit" if you
want to see labels in Japanese:
The m17n library utilizes the m17n database available at:
http://www.m17n.org/m17n-lib/m17n-db
Without this database, the m17n library loses half its value. Please
-install it too before you try the above sample programs or develop a
-program that uses the m17n library.
+install it (Ver.1.4.0 or the later is required) too before you try the
+above sample programs or develop a program that uses the m17n library.
(3) DOCUMENTATION
the source files. There are English and Japanese comments in
parallel.
+
(4) USAGE
The library provides three levels of APIs, CORE, SHELL, and GUI. For
CORE API, include <m17n-core.h>, for SHELL API, include <m17n.h>, and
-for GUI API, include <m17n-gui.h >. See the documentation above, or
-the manual of m17nIntro(3) for more detail.
+for GUI API, include <m17n-gui.h >. In addition, for those who need
+only text shaping facility that uses FLT (Font Layout Table), the
+library provides FLT API. To use it, include <m17n-flt.h>.
+
+See the documentation above, or the manual of m17nIntro(3) for more
+detail.
The shell script "m17n-config" helps compiling and linking of a
program that uses the m17n library. For instance this compiles PROG.c
% gcc -o PROX `m17n-config GUI --cflags` `m17n-config GUI --libs` PROX.c
+
----------------------------------------------------------------------
Copyright information
-Copyright (C) 2003, 2004
+Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008
National Institute of Advanced Industrial Science and Technology (AIST)
Registration Number H15PRO112
You should have received a copy of the GNU Lesser General Public
License along with the m17n library; if not, write to the Free
-Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
-02111-1307, USA.
+Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+Boston, MA 02110-1301, USA.