本文簡述 xcin-2.5 安裝步驟與準備工作:

---------------------------------
A. 系統需求:

由於 xcin-2.5 以後全部採用 Xi18n 與 locale 而設計，因此在安裝本程式前，
您必須在您的系統中準備好 I18N 與適當的 locale 環境，同時您的系統中必需
要有完整的 X11R6 系統以及所需的字型。如果您不確定您的系統的 I18N 與 locale
環境是否已安裝妥當，您可以參考 FAQ 文件的 QA.2, QA.3 的說明來進行檢查。
或者參考:

	ftp://xcin.linux.org.tw/pub/xcin/i18n/i18n_tool.tar.gz

內附的說明文件。

目前 xcin-2.5 已可在 GNU/Linux, FreeBSD, 以及 HP-UX 等系統下成功安裝，
各系統的安裝需求如下:

1. GNU/Linux: 
     a. 使用 glibc-2.1.x 以上 (雖然經由一些特殊處理，也可以將 xcin 安裝在 
	glibc-2.0.x 的系統中，但這會導至許多潛在問題，我們不建議這麼做)。
     b. gcc-2.7.2 以上。
     c. XFree86-3.3.6 以上 (雖然經由一些特殊處理，也可以將 xcin 安裝在所有
	的 XFree86-3.3.X 系統中，但這會導至一些潛在問題，故我們不建議這麼做)。
     d. 適當的 locale 支援, 如 zh_TW.Big5, zh_CN.GB2312 .... 等，及相對應
	的中文字型。由於並非所有的 GNU/Linux 系統套件都會有這些 locale 支
	援，故如果您的系統沒有的話，您可以參考
	    ftp://xcin.linux.org.tw/pub/xcin/i18n/i18n_tool.tar.gz
	來建立您的 locale 環境。

2. FreeBSD:
     a. 建議 FreeBSD-4.0 以上，支援 locale 與 ELF。
     b. gcc-2.7.2 以上。
     c. XFree86-3.3.6 以上 (雖然經由一些特殊處理，也可以將 xcin 安裝在所有
	的 XFree86-3.3.X 系統中，但這會導至一些潛在問題，故我們不建議這麼做)。
     d. 適當的 locale 支援, 如 zh_TW.Big5, zh_CN.EUC .... 等，及相對應的中
	文字型。

3. HP-UX:
     a. 建議 HP-UX B.10.XX 以上的系統。
     b. ANSI C compiler。
     c. 適當的 locale 支援，如 zh_TW.big5, zh_HK.hkbig5 .... 等，及相對應的
	中文字型。


---------------------------------
B. 安裝 xcin-2.5:

1. Berkeley DB2:
   如果您安裝 xcin-2.5 時想要安裝 bimsphone 模組，則您需要 Berkeley DB2，
   否則的話不需要。請注意若您不想安裝 bimsphone，您必須在 configure xcin 
   時加入 --disable-bimsphone 選項 (詳見後述)，如此當 xcin 在 configure
   時才不會去檢查 Berkeley DB2。

   如果您用的是 GNU/Linux glibc-2.1.X 的話，系統中已內含了 Berkeley DB2, 
   故您可直接進行 xcin-2.5 的安裝。若您的系統沒有 Berkeley DB2, 您可以到
   以下這幾個地方找到它:

	http://www.sleepycat.com
	ftp://xcin.linux.org.tw/pub/xcin/misc/db-2.7.4.tar.gz

2. libtabe:
   自 xcin-2.5.1 及以後的版本， libtabe 已自 xcin 套件中分離並獨立維護，
   若您安裝 xcin-2.5 時想要安裝 bimsphone 模組，則您還需要 libtabe，否則
   的話不需要。請注意若您不想安裝 bimsphone，您必須在 configure xcin 時
   加入  --disable-bimsphone 選項 (詳見後述)，如此當 xcin 在 configure 時
   才不會去檢查 libtabe。

   您可以在這裏找到穩定版的 libtabe 套件:

	ftp://xcin.linux.org.tw/pub/xcin/libtabe/libtabe-<version>.tar.gz

   或在這裡找到尚在發展中版本的 libtabe 套件:

	ftp://xcin.linux.org.tw/pub/xcin/libtabe/devel/libtabe-<version>.tar.gz

   請注意，由於 xcin 是隨著 libtabe 一同發展的，因此不同版本的 xcin 需要其
   相對應的 libtabe 版本一同安裝才行。為了方便起見，您總是可以在和下載 xcin
   相同的 ftp 站目錄下找到其正確的 libtabe 版本。例如: 如果您打算安裝 xcin
   穩定版，則您必須安裝穩定版 xcin 所需的 libtabe 套件:

	ftp://xcin.linux.org.tw/pub/xcin/xcin/libtabe-<version>.tar.gz

   另一方面，如果您打算安裝最新的發展中 xcin 版本，則您也必須安裝

	ftp://xcin.linux.org.tw/pub/xcin/xcin/devel/libtabe-<version>.tar.gz

   中最新的 libtabe 版本。有關本版 xcin 套件所需的 libtabe 版本，請見 README
   一文中第 C 節的說明。

   若您的系統有 shared library 的支援，建議您將 libtabe compile 成 shared
   library, 以結省硬碟空間。以下是快速安裝指引 (詳見 libtabe 的文件說明):

	gzip -dc libtabe-<version>.tar.gz | tar -xvf -
	cd libtabe
	./configure --prefix=<path> --enable-shared
	make install

3. GNU Gettext: 
   在 GNU/Linux 與 FreeBSD 系統中，如果您希望 xcin 可以做多國語言訊息顯示的
   話，您的系統中必須安裝 GNU Gettext 套件。否則的話不需要。

4. xcin 穩定版原始碼可以在這裏取得:

	ftp://xcin.linux.org.tw/pub/xcin/xcin/

   若您想試試最新的測試版，則您可以在這裏取得:

	ftp://xcin.linux.org.tw/pub/xcin/xcin/devel/

   xcin 的原始套件檔名通常為: xcin-<version>.tar.gz, 其中 <version> 為版
   本名，若您在其中見到 pre 的字眼或日期編號，表示它是測試版，否則為穩定
   版。當您取得您所需的版本後，請用以下的方式將它解開:

	gzip -dc xcin-<version>.tar.gz | tar -xvf -

   完成後您會得到一個 xcin-2.5 的目錄。

5. 請到 xcin-2.5 目錄下，執行 configure 程式。一般說來，如果 xcin 所需的
   額外 library (如 Berkeley DB2, libtabe 等) 都放在相同的位置，您只要執行:

	./configure --prefix=<安裝路徑> \
		    --with-extra-prefix=<額外 library 的所在路徑>

   即可。除此之外， configure 還可以接受其他參數，您可以視需要加入。其各
   參數的意義如下:

	--help
	    列出使用說明。

	--prefix=PATH (預設值為 /usr/local)
	    設定安裝路徑為 PATH ，則 xcin 將安裝到以下的目錄中:

		執行檔:  $PATH/bin
		資料檔:  $PATH/lib/xcin
		設定檔:  $PATH/etc

	--binpath=PATH (預設值為 ${prefix}/bin)
	    設定 xcin 執行檔的安裝路徑為 PATH

	--with-xcin-dir=PATH (預設值為 ${prefix}/lib/xcin)
	    設定 xcin 資料檔的安裝路徑為 PATH

	--with-xcin-rcdir=PATH (預設值為 ${prefix}/etc)
	    設定 xcin 設定檔的安裝路徑為 PATH

	--with-localedir=PATH (預設值為 ${prefix}/share/locale)
	    設定系統 locale 目錄路徑，用來安裝 xcin LC_MESSAGES 訊息檔。

	--with-extra-prefix=PATH (預設值為 ${prefix})
	    設定額外 library 的所在路徑為 $PATH。由於安裝 xcin-2.5 您需要 
	    Berkeley DB2, libtabe .... 等額外的 lib, 您除了可以一一設定這
	    些 lib 的所在路徑以外 (見後頭的選項說明)，若這些 lib 都安裝在
	    相同位置，則您也可以在這裏直接設定它們的所在位置，如此一來就
	    不需要打一長串的 configure 參數了。

	    本選項值一旦決定之後，則 configure 便會自動設定以下兩個參數:

		extra_include=-I$extra_prefix/include
		extra_library=-L$extra_prefix/lib

	    而在 configure 與 compile 階段，所需的額外 lib 與 include 都
	    會依上述那兩個變數值來做搜尋。

	--with-extra-inc=PATH (預設值為 ${extra_prefix}/include)
	    設定額外的 library 的 include 位置。

	--with-extra-lib=PATH (預設值為 ${extra_prefix}/lib)
	    設定額外的 library 的 lib 位置。

	--disable-bimsphone (預設是 enable)
	    不安裝 bimsphone 模組。由於安裝 bimsphone 模組需要 Berkeley DB2
	    以及 libtabe，在預設情況下 xcin configure 程式會檢查這兩個套件
	    是否存在於您的系統中，若不存在則印出錯誤訊息並停止後續動作。若
	    您不想安裝 bimsphone 模組時，您必須在 configure 時加入此選項，
	    則 configure 程式將不會檢查 Berkeley DB2 以及 libtabe, 同時在編
	    譯時也不會去編譯 bimsphone。

	--with-dbinc=PATH (預設值為 ${extra_include})
	    設定您系統的 Berkeley DB2 include 路徑為 PATH

	--with-dblib=PATH (預設值為 ${extra_library})
	    設定您系統的 Berkeley DB2 library 路徑為 PATH

	--with-tabeinc=PATH (預設值為 ${extra_include})
	    設定您系統的 libtabe include 路徑為 PATH

	--with-tabelib=PATH (預設值為 ${extra_library})
	    設定您系統的 libtabe library 路徑為 PATH

	--with-intlinc=PATH (預設值為 ${extra_include})
	    設定您系統的 libintl include 路徑為 PATH (for gettext)

	--with-intllib=PATH (預設值為 ${extra_library})
	    設定您系統的 libintl library 路徑為 PATH (for gettext)

	--x-includes=PATH (沒有預設值)
	    設定您系統的 X Window include 檔的路徑為 PATH

	--x-libraries=PATH (沒有預設值)
	    設定您系統的 X Window library 的路徑為 PATH

	--enable-debug
	    開啟 Debug 選項。

   請注意，如果您使用的是 GNU/Linux glibc-2.1.2 以前 (包括 2.1.2) 的系統
   時，在 configure 完成後，會產生一個 config.h 檔。請修改該檔案的內容，
   將底下這一行刪除:

#define HAVE_NL_LANGINFO 1

6. 開始編譯:
	make
	make install

7. 修改 $RCPATH/xcinrc 的內容，依據您的 locale 環境做適當的設定:

   一般而言，若是 GNU/Linux、FreeBSD、或者是 HP-UX 系統，其 xcinrc 的預設
   值已可以使用，故不需要額外修改。但對於不同的 UNIX 系統，其 locale 環境
   與所使用的字型可能都不一樣，故必須做適當的設定。有關 xcinrc 的設定說明
   請見 Usage 與 modules/* 的說明。

8. 各 UNIX 平台的額外注意事項:

   HP-UX:
	HP-UX 的預設 CDE 環境啟動時，其 xmodmap 的組態可能會造成 xcin 某些
	功能鍵失效。請您做如下的檢查: 執行 xmodmap，並注意其 mod1 的值，如
	果您見到的是
		mod1        Meta_L (0x22),  Meta_R (0x42),  Mode_switch (0x84)

	這時您必須執行:
		xmodmap -e "remove mod1 = Mode_switch"

	將 Mode_switch 的設定解除，換句話說，只需保留 Meta_L 與 Meta_R 的設
	定即可。您也可以將這個指令寫在適當的地方，以便每次 login 進入 CDE 環
	境時都會自動執行。詳見 xmodmap 的 man page 以及您的 CDE 說明文件。

9. 若在 $XCINPATH/tab/ 底下找不到您慣用的輸入法表格，請參考 Cin 一文的說
   明來修改、編寫您的 .cin 檔。


---------------------------------
C. 測試:

相關的測試與操作細節，請見 UserGuide 與 Usage 二文的說明。


T.H.Hsieh
