Last modified on 
	$Id: README,v 1.18 2002/04/18 09:27:42 phj Exp $

NOTE:
如果你是第一次使用这个软件,请以时间的先后顺序来阅读这个README文件(也即
从文件尾部往文件头倒着阅读).如果您有好的建议或想法请你告诉我,我将使
这个软件更加完善.如果你觉得这个软件还好用的话,请你寄一张明信片给我,
以示对我的鼓励,现在,我的功课非常多,所以我不会经常的改进这个软件,如果
有人想参加到这个软件的开发中来的话,我将非常高兴的欢迎您.希望将来有更多的人
不再为敲入汉字而发愁。

我的地址: http://www.tepus.com/~phj
	 关于chinput2的最新信息请查看http://www.tepus.com/~phj/chinput2.html

2002.04.17:
	chinput2现在已经支持连续输入拼音。
	另外,以前编译的chinput2-1.2.1不能与mysql-3.23.X(cn.freebsd.org上使用的MySQL server版本)
	使用,这是由于编译chinput2使用的mysql-client程序不对应造成的结果。

2002.02.17
        Mozilla-0.85+,Vim-5.5+,Emacs-21.x和XEmacs-21.x都已经默认支持multi-byte,
	所以大家在使用它们的时候会比较方便。只是一定要记得在FreeBSD的shell环境变量中
	设置如下参数:
	   $LC_CTYPE=zh_CN.EUC
	   $XMODIFIERS=@im=Chinput
	   $export LC_CTYPE XMODIFIERS

2002.02.16
        很久没有更新chinput2了,今天一看,才知道mysql-server已经更新到3.23.48了,
	发现3.23.x引入的一个BUG,它的primary key方式不支持8bit字符,这直接导
	致了chinput2使用出现问题。为避免这个问题,在create table 时,需要使用如
	下方式建表:
		create table pydb(
		  pinyin varchar(255) not null,
		  hanzi varchar(255) not null,
		  freq float(23,0) not null,
		  last_used TIMESTAMP(14) not null,
		  key(hanzi),
		  key(pinyin)
		);
	也就是去掉对汉字使用primary方式,这样对性能有稍许影响。


	如果大家可以使用internet的话,那么可使用如下的配置来使用chinput2,而
	不需要在自己的机器上安装mysql server。修改/usr/local/etc/chinput2.conf
	为如下配置:
    	hostname	www.cn.freebsd.org
	username	pydb
	password	pydb
	database	pydb
	table      	pydb
	port		3306
	max_latest_len	0
	max_words_len   14

        另外,这个表中的条目可以作为分词的依据。

2001.02.01
	加入对big5码环境的支持,使用
		CTRL-F1作为切换键:    简体全拼<-->繁体全拼

	已经解决了2001.01.08中所提到的bug。

2001.01.08
	这个软件目前所知道的唯一一个bug是,当用户长期不使用chinput2后,再去使用
	时,它将会"莫名奇妙"的掉下来,其实这是因为MySQL的socket连接只保持大约八
	个小时(具体的值我记不大清了),所以今后只要加入保持连接的代码就行了。另
	外,add_items和chinput2与数据库的接口部分需要加入缓冲,以提高效率,
	不然的话,Pentium-133的机器跑起这个软件来有点吃力。但是这样子的做法就
	是"用空间换取效率",不知道这样做值不值得,除非将来人们的机器里的RAM越来
	越多,否则我可能不会加入这部分代码。

2000.11.09
	在正式使用chinput2之前,需要在数据库中加入初始部分,它们就是所有的GB2312
	汉字,这只需要在库,以及表建立之后,运行add_items就可以了.它的使用是这
	样的.如果你对某篇文章感兴趣的话,使用
		add_items any_files_with_gb2312_hanzi
	但是,如果文件太大,那么词汇的加入速度会比较慢(实际上还是比人的学习要来得
	快得多).

2000.11.05
	关于这个输入法的产生过程中的一些想法:
	在实现这个输入法之前,我曾想:如果每个机器上都需要保留一个词库,
	那么这实在是个资源的浪费,因此我想到了Client/Server方式的实现.
	这也是导致我使用数据库的一个原因.因此如果在一个工作组或是一个有
	较高带宽的局域网系统中,如果有一个数据库,就可以使所有人拥有一个
	能被多数人所使用的较高频度的词汇库,这样在大家作汉字输入时就会提
	高效率.并且这个库中的表是可以被定制的(我认为这才是这个输入法的
	最大的优点,能实现这一点很大程度上要感谢那些为数据库系统作出贡献的
	人们,但数据库的选择是不受限制的.你可以修改数据库接口文件以使用任
	一种数据库.)

2000.11.04
	为了能够让这个输入法不影响Emacs(指GNU Emacs,我没有测试过
	它与XEmacs的兼容性,希望其他的人能作这个工作)本身的输入,我使得
	chinput2不与Emacs的控制键相冲突.因此我使用了如下的按键集:
	
	Shift-SPACE ==> 开关,用以激活或隐藏chinput2.
	CTRL-F1	  ==>   切换简体全拼<-->繁体全拼.
	CTRL-F4   ==>   退出chinput2.
	CTRL-.    ==>   清除当前拼音缓冲区的内容.
	CTRL-,	  ==>   开关,用以控制是否需要即时更新数据库(默认为自动更新).
	=         ==>   用于选字时的翻页(后翻).
	-         ==>   用于选字时的翻页(前翻).
	1,2,3,4,5,6,7 ==> 用于汉字的选取.
	
	实际上以我的经验,在你使用这个软件一段时间后,你基本上很少需要
	使用翻页的功能(我想这是这个软件比较好的一个特性).
	使用这个软件需要同时安装MySQL数据库.因此希望你能了解一些数据库的
	知识,比如添加用户并授权,以及建库和建表,安装了MySQL后,需要用户(也
	就是你自己)创建一个数据库,以及一个表,
	它的格式是这样的(例):

	create database pydb;
	use pydb;
	create table pydb(
		pinyin varchar(255) not null,
		hanzi varchar(255) not null,
		freq float(23,0) not null,
		last_used TIMESTAMP(14) not null,
		key (hanzi),
		key(pinyin)
	);

	建了库及表后,请记下库名,表名和用户名以配置chinput2的配置文件
	/usr/local/etc/chinput2.conf:
	hostname	10.1.1.3
	username	john
	password	dkUkdk
	database	pydb
	table      	pydb
	port		3306
	max_latest_len	0

	以上变量解释如下:
	hostname:	主机的IP地址,当然也可以使用主机名.
	username:	数据库的用户名.
	password:	登录数据库的口令.
	database:	数据库名
	table:		你所使用的表名.(不同的人可以使用不同的表以定制
			自己所习惯的词汇表.同一个人也可以使用不同的表以
			保持不同专业类型的词库.)
	port:		这就是MySQL数据库的端口.
	max_latest_len: 表示你想最多优先显示几个最近所敲入的词.
			特别的当max_latest_len=0时,表示你只使用
			统计频率最高的词作为首选词.如果你不是经
			常使用不常见词汇,建议设定max_latest_len为0
	
2000.11.03
	使用Emacs时还需把下面的内容加入到
	~/Emacs中去.
	Emacs.font: 8x16
	Emacs.Fontset-0: hanzigb16fs,\ 
	  chinese-gb: hanzigb16fs,   \
	  ascii: 8x16

2000.10.25
	如果所使用的Emacs已经支持XIM协议(如果没有可以到
	http://www.ainet.or.jp/~inoue/software/emacs-xim/index-e.html
	上下载针对XIM支持的patch.)当使用Emacs时,特别是指的Emacs20.7(这是我
	作测试的平台),那么为了使Emacs能正确的显示汉字,那么要在
	~/.emacs中加入如下的两行
        (set-language-environment "Chinese-gb")
	(set-keyboard-coding-system 'cn-gb-2312)
	当然你要已经设置好了GB fontset .

2000.09.07
	写这个版本的目地是因为在移植Linux平台下的chinput到FreeBSD的过程中,
	我发现它不稳定,可能是因为我只拿到了chinput-2.1版本的缘故(chinput-3.0
	有很大的改进,代码也写的非常的有条理.)

	为了使这个中文输入(特别是简体中文部分)服务器能够做到robust,所以决定
	重写chinput,取名为chinput2.意思是指chinput的另一个版本.在此我要感谢
	于明俭老师,没有他的chinput,当然也就不会有chinput2。还要感谢addpy的
	作者,我使用了他所写的GB2312拼音与简体汉字的对照表.还有IMdkit的作者
	Hidetoshi Tajima,没有这个工具,我也无法在这么短的时间里写出chinput2。
	最后还要感谢CXterm的作者:
        Copyright 1994, 1995, Yongguang Zhang.
        Copyright 1991, Yongguang Zhang and Man-Chi Pong.
        (copied from man page of cxterm.)
	是他们最早为Free UNIX世界提供了X环境下的中文工具.







