/*
Copyright 1990-2001 Sun Microsystems, Inc. All Rights Reserved.

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions: The above copyright notice and this
permission notice shall be included in all copies or substantial
portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE OPEN GROUP OR SUN MICROSYSTEMS, INC. BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE EVEN IF
ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH DAMAGES.


Except as contained in this notice, the names of The Open Group and/or
Sun Microsystems, Inc. shall not be used in advertising or otherwise to
promote the sale, use or other dealings in this Software without prior
written authorization from The Open Group and/or Sun Microsystems,
Inc., as applicable.


X Window System is a trademark of The Open Group

OSF/1, OSF/Motif and Motif are registered trademarks, and OSF, the OSF
logo, LBX, X Window System, and Xinerama are trademarks of the Open
Group. All other trademarks and registered trademarks mentioned herein
are the property of their respective owners. No right, title or
interest in or to any trademark, service mark, logo or trade name of
Sun Microsystems, Inc. or its licensors is granted.

*/

ude --  User Defined Engine, SunIM based Simplified Chinese conversion 
	engine module.

HOW TO BUILD:

    1. If Makefile does not exist, run configure script at src/server. 

	$ cd /somewhere/src/server
	$ sh configure

	You can specify your favorite options if you want. 

    2. Run GNU version of make command.
	
	$ cd /somewhere/src/server/programs/language_engines/ude
	$ gmake

    	`ude.so' will be created in current directory.

HOW TO INSTALL:

    1. If package SUNWiiimd are installed, ignore these 3 steps.
       Otherwise, manul installation is needed.

    2. copy `ude.so' to a directory, for example:

	$ cp /somewhere/src/server/programs/language_engines/ude/ude.so ~/

    3. copy code table file `pinyin.mb' to the same direcroty

	$ cp /somewhere/src/server/programs/language_engines/ude/data/pinyin.mb ~/

HOW TO USE:

    1. make sure the code table file is located at <the path of `ude.so'>,
       or at "<the path of `ude.so'>/../locale/zh_CN/ude/data"
	
    2. start htt_server with -if ude option

	htt_server -if ude -ifpath_name <the path of ude.so>

    3. start client.

HOW TO ADD YOUR OWN CODETABLE:

    1. Realize the code table format: (for example, pinyin.mb)

    **** pinyin.mb ****

    #
    # ȫƴ뷨
    #
    <codetable_info>			# code table infomation
    name            ƴ 		# the name of this input method
    locale          zh_CN		# locale
    wildchar        *			# a char to replace preedit keys
					# for expample. 'z' is a wildchar in "Wubi" input method
    <preedit_keytable>			# do not use now
    <codetable>				# code table
          a				# format:
          a				# characters(or strings)	preedit string
    ....

    2. Create new code table according to this format

    3. copy the code table file to the direcroty <the path of `ude.so'>.

    4. restart htt_server and client

    5. make conversion on, Press Alt+2, the new input method will be active.




