Traditional Chinese Language Engine for IIIMF
---------------------------------------------

Copyright: GPL


Developers:
Ervin Yan     <ervin.yan@sun.com>
Phill Zhang   <phill.zhang@sun.com>
Gavin Tu      <gavin.tu@sun.com>

Simplified Chinese language engine support:
 - Chewing input method
 - Cangjie(5) input method
 - Array30 input method
 - Dayi input method
 - Boshiamy input method
 - ChuYin input method (with Eten/IBM... keymapping)

support the following features:
 - a new layer API for input method developer
 - Customizable styles for preedit/candidate
 - properties setting for input method (ime developer do not need write gtk2 source to support IME properties setting.

TODO:
-----
- leverage the IME layer API as LEIF part

Compile & Installation:
-----------------------
1. ./autogen.sh (regenerate configure, Makefiles..)
2. ./configure
3. make
4. make install

-- To manually regenerate configure, Makefile, etc
libtoolize
aclocal
autoheader
automake --add-missing
autoconf
./configure

To Run:
-------
For Gnome/GTK+2 applications with iiim immmodule:
# /usr/bin/iiimd &
# export GTK_IM_MODULE=iiim
# LANG=zh_CN.UTF-8 gedit&
# LANG=zh_TW.UTF-8 gedit&
# LANG=zh_HK.UTF-8 gedit&
# LANG=th_TH.UTF-8 gedit&

For KDE/Qt/Java/StarOffice or any application without direct support of IIIMF, then we need to use the IIIMF<->XIM backward support bridge:
# /usr/bin/iiimd &
# LANG=zh_TW.UTF-8 /usr/bin/iiimx
# export XMODIFIERS=@im=iiimx
# LANG=zh_TW.UTF-8 kedit


Usage:
------
- Activate the input method: ctrl-space
- Change input method: ctrl-shift
- Press space to commit the first character
- Press number [1-9] to commit the candidates

Debug:
1. compile the source codes with command:
   # ./autogen.sh --enable-debug; make all; make install

2. stop all iim and aux processes:
   # pkill -9 iiim; pkill -9 aux

3. start three xterm.

4. in one xterm, run:
   # gdb /usr/bin/iiimd
   # (gdb) run -d

5. in one xterm, run:
   # /usr/bin/iiimx -if twle

6. in one xterm, run:
   % gedit

7. type ctrl+space
