
*************** How to install **************************
1. Edit Imakefile (or use Imakefile.freedom, Thanks to freedom@csie.nctu.edu.tw)
   Modify the following variables if necessary.
     ETDIR       default is /dosd/et3       where the Eten system is located
		 If you cannot use dos file system,   copy your Eten system
		 to a directory, and modify ETDIR.
     Delete_K	如果你想把 Delete 當 backspace 用  Delete_K=1
	        很多人的 Delete_K=0 時, Backspace 不能用，特別是
		Linux Slackware, 這時候在 .xinitrc 加入
			xmodmap -e 'keycode 22 = BackSpace'

		這樣用 crxvt 時按 Backspace 才不會有刪錯字問題
		( crxvt 有自動 erase 完整一個字的能力，可是
		  Backspace 與 Delete 鍵必須分開 )

		加入 xmodmap 以後，你可能會發現在某些程式 backspace
		不能用，這時候你必須設定 stty erase '^H'，但是
		你 stty 以後， linux console 又會有問題，
		你可以參考 rc/tcshrc 的解決辦法。

     Auto_First 這是詞音輸入法中的新功能，詞音現在可以記住你上一次選
		的字，不過並沒有自動學習詞的能力，所以可能有一些副作
		用，如果你要 Disable, Auto_First=0

2.   % xmkmf                  creat Makefile

3.   % make                    run make
	   will build all exec files and tables and fonts

4.   % make install
	   will install the files.

************ How to use **********************************
★ xcin 必須搭配 crxvt 使用, 所有 keyboad input 應該在 crxvt 的 window 內輸入，
   不是在 xcin 的 window 輸入，這個問題已經有人問好幾次了，希望不要再出現了
★ xcin & crxvt 也可以不用 et24m & vga12x24 的字型，請看以下的設定。
---------------------------------------------------------------------------
resource name    command line     Description
(放在 .Xdefaults) 命令參數
---------------------------------------------------------------------------
xcin.fnb5:	 -fnb5            Big5 字形 font name,(default:et24m)
xcin.fn:         -fn              ASCII英文字形 font name,(default:vga12x24)
xcin.geometry:   -g or -geometry  xcin 輸入視窗的位置
					  (e.g.  +100-0   at left-bottom)
xcin.phokbm:     -phokbm          zo:    零壹
				  eten:  Eten
				  et26:  Eten 26
				  hsu:   許氏鍵盤

xcin.vocbox:     -vocbox	  your vocabulary box name, must be full path
				  詞庫輸入法的檔案名稱

xcin.inmd:	 -inmd            the input method you use
				  1:倉頡  3:注音  8:行列30
			          10:內碼  11:詞庫
    如果你有設定此參數，則 xcin 執行後可直接按 ctrl-space 進入你要的輸入法。
    你也不需要按 ctrl-alt-I 來選擇你的拆字顯示，都幫你設定好了。

xcin.fg		 -fg		  foreground color
xcin.bg		 -bg		  background color
xcin.infg	 -infg		  fg color of input area
xcin.inbg	 -inbg		  bg color of input area
xcin.phrase	 -phrase	  your phrase file name  (binary format)
				  (Press Alt-Shift-  )
xcin.going	 -going		  0:   不使用 (default)
				  1:   同國音的方式使用 '↓' 選同音字，
				       空白鍵可用來輸入空白
xcin.vb	 	 -vb		  0:   不使用靜音
				  1:   使用靜音 (visual bell)
xcin.hidden      -hidden          0:   不使用隱藏視窗
				  1:   自動隱藏 xcin 視窗
-------- setup input method -----------------------------------------------
如果你要使用倉頡、行列或是自己的輸入法，要用以下的參數

xcin.in1         -in1       the input table you want to install over Ctrl-Alt-1
			    (Example)       -in1 cj.tab    掛倉頡
xcin.in2         -in2

xcin.in4         -in4
   |
xcin.in5

xcin.in7
   |                                        -in8 ar30.tab  掛行列30
xcin.in9         -in9
------------------------------------------------------------------------
與倚天類似的輸入環境:
   .   ctrl-Space 中/英   shift-Space 全/半
   .   ctrl-1  ctrl-3  ctrl-6 ctrl-8  ctrl-0  ctrl--  選擇輸入法
   .   倉頡  行列30 均有 一級 二級 簡碼
   .   倉頡  行列30 都有提供 wild card 功能, 即類似 DOS file name
       中可用 '＊'或　'？'來取代未知部份的功能, 而且第一個 key
       可用 '＊' 或 '？'
   .   查詢拆字的功能(ctrl-alt-I) 可用注音查某字"倉頡","行列" 及任何以
       cin2tab 產生的輸入法，也可以用來查 BIG5 內碼。
   .   可使用片語 (Alt-Shift- Key)
   .   Ctrl-Atl-R 重覆上一個字的功能
   .   注音、倉頡、行列 ... 都有自動送字的功能
       即若有重覆字時，若第一個字剛好是你要的字，可直接輸入下一個字，
       不需要按數字鍵去選。你也可以按空白鍵送出第一個字。
   .   目前已有輸入法 :
	   倉頡 注音 詞音(忘Ｘ) 行列30 內碼 詞庫
--------------------------------------------------------------------------
行列30, 倉頡, etc user's note:
ヾ 一級簡碼:
	使用者可自定，行列30與市面上的相同。
	若使用者沒有設定，則顯示下一個 key column 相同字中 BIG5 seq 最小的
	字。
ゝ 2.3.4 ... 級簡碼
	如果你忘了如何拆字，可以看看簡碼顯示的提示。
★ 現在可以在 .cin 檔中定義 "詞" , 且可以形成重覆鍵,
   See sample.cin for more information
--------------------------------------------------------------------------
詞音輸入法使用注意事項：
1. 按 ctrl-alt-6 進入詞音輸入。
   初次使用 xcin 會在 user's home directory create a dir named 'xcin_dir',
   並把 data file copy 一份。 XCIN 的辭庫放在 xcin_dir 這個 directory
2. 要存 phrase 可用 兩種方法
      . 可用 keypad 上的 '*' 選擇範圍儲存。
      . Shift-Enter:   從 curosr 開始存到末端
   存完 cursor 自動跳到末端，以方便繼續輸入。
3. 有  text <-> tsin table 轉換程式:
      tsa2d:        text table -> binary table
      tsd2a:	    binary table -> text table

   tsa2d 會自動刪除重覆的 phrase, 所以如果你要合併兩個 text 可直接用
	cat a b | tsa2d
   ┌────────────────────────────────┐
   │ 注意, 如果用 tsa2d 改變了 xcin_dir/tsin, 必須重新執行 XCIN 否則│
   │ 會導致  crxvt & xcin terminate                                 │
   └────────────────────────────────┘
4. 如果你要用 editor 直接修改 tsin.src 請注意 '1' 是代表輕聲，不是第一聲。

5. 如果你認為 xcin 選出來的同音內定字不是常用字可修改 'pho1st' 檔, 重新 make
   一次。
6. 在存很多片語以後, 最好用 d2a, a2d 重新整理 xcin_dir/tsin, 這樣資料比較
   不會亂掉(reindex)
   ヾ 把 d2a, a2d, tsd2a, tsa2d copy 到 xcin_dir/
   ゝ 執行 d2a, 如果你發現 tsin.src 有亂碼, 很抱歉, 你的 tsin 檔是壞的，
      用 joe 把 那些壞掉的部份清掉。
   ゞ 執行 a2d 即完成整理工作
7.以後要打 。，：？； 不用那麼麻煩了，可以用以下的注音。
	。->ㄐ   ，->ㄉ   ：->ㄇ  ？->ㄨ˙   ；->ㄈ   ！->ㄊ
	、->ㄉˇ •->ㄉ2  ＄->ㄑ  ＊->ㄒ

    '˙'是輕聲。 至於為什麼要用ㄐㄉㄇㄨㄈㄊ，不需要提示吧！
    你也可以改 pho1st 檔定其它符號。
8.  增 -going 參數，請參考前面的表。
9.  如果有讀音相同的詞，則第一次選了以後，以後就不需要再選，xcin 會記
    住上一次選的詞
    (例如:  打  ㄧ  ㄓ  會出現  1一支 2一隻 3一枝的重覆詞，
		      若選  "2一隻"  則以後都是"一隻" 優先出來。
--------------------------------------------------------------------------
How to upload phrase file  如何上載片語檔

 * XCIN 現在會自動上載 sample.phs, 所以你不再需要多一道手續。
 * -phrase 可設定你要的片語檔。 使用前先用 phs_out 轉成 binary format

% lphrase  your_phrase_file <Enter>
	   (text format)
phrase 檔的範例請看 sample.phs,   用 Alt-Shift-(key) 叫出片語。

!!!!   片語未尚載完成，勿按任何鍵(Enter 鍵不要按太久)，
       或動 mouse 否則會導致 xcin terminate。
--------------------------------------------------------------------------
Note:
	. 必須有 xcin 的 client 才可以測試   (crxvt or cxterm_patch)
	. 若是使用 Sun's keyboard, Alt-key 為 meta-key， 即有菱形符號的 key
--------------------------------------------------------------------------
*******  如何使用讓 X11 軟體能使用 xcin 輸入中文 *******
See XCIN.client.doc  接受 xcin 的中文輸入很容易，可是中文顯示就比較麻煩。

*******  如何加新的輸入法到 xcin *******
請看 sample.cin 裡有格式說明。用 cin2tab 轉換成  .tab .rev .quick(optional)

******** 如果你沒有中文字型 **********
big5font directory 底下有 字型轉換程式, 可以用用看.  很多人用的
taipei??? 字型 沒有包含 c6a1-c8d3 的日文字及特殊符號.   此轉換程式有.

*******  crxvt  新增功能  **********
若使用 news reader or BBStext 中有設定 screen 的顏色的  escape sequece,
可按 (Ctrl-Alt-O) 還原正常的 attribute.

crxvt 有一般中文系統 cursor 自動跳至字開頭的能力, 所以不必再擔心刪到第二個
byte 而產生亂碼的情形。 如果你想切換, 可按 (Ctrl-Alt-T)。 如果你想一進
crxvt時是 disabled, 可用 "  -autocursor-  " disable

現在可以設定 crxvt cursor 的顏色了:
   -cr number[0-7]     此編號與 ansi color 相同。

crxvt 有像 xterm 顯示 bold 字體的能力,只是被我拿掉了，因為在 color ls 顯示
出的字很醜，可以改 screen.c enable
