²z xcin ާ@Ӹ`:

1. Command line & ܼ:

    xcin -h, z|HUϥλ:

===========================================================================
XCIN (Chinese XIM server) version xcin <version number>
(module ver: <version number>, syscin ver: xcin-<version number>).
(use "-h" option for help)

Usage:  xcin [-h] [-d DISPLAY] [-x XIM_name] [-r rcfile]
Options:  -h: print this message.
          -d: set X Display.
          -x: register XIM server name to Xlib.
          -r: set user specified rcfile.

Useful environment variables:  $XCIN_RCFILE.
===========================================================================

   He xcin jqROCﶵw rcfile  ( 2 I)CFR
   OCﶵP rcfile ~A xcin ٥iHUܼ:

   LC_CTYPE:     ]wrBz locale, w]O "zh_TW.Big5"
   LC_MESSAGES:  ]wTX locale, w]O "C"  "POSIX" (^)
   XCIN_RCFILE:  w] rcfile ɦW


   pGY]wPɦbROCﶵBܼơBH rcfile X{ɡAh xcin
   wuǬ:

	ROCﶵ > ܼ > user rcfile > default rcfile > xcin default

   Y]ROCﶵPܼơA xcin HwȨӱҰʡC xcin wOŪ
   $RCPATH/xcinrc w] rcfile, 䤤 $RCPATH ȬO configure/make 
   w (w]O /usr/local/etc  /etc)C xcin u|Ū@ rcfile, 
   jM rcfile Ǭ:

	$HOME/.xcin/xcinrc	(]z XCIN_USER_DIR O] ".xcin", Uz)
	$HOME/.xcinrc
	$RCPATH/xcinrc		(tιw] rcfile)

   ]A@ϥΪ̭YNtιw] rcfile ]wȡAhWunNtιw]
    rcfile Ƥ@ $HOME/.xcin/  $HOME/ UAANק令ۤvߦn
   պAYiAΥѩROCﶵܼƤwC



2. XIM (X Input Method) server:

   b XIM [cA{ءA@ XIM server, t@ XIM client C XIM
   server OΨӴѿJk{A XIM client hO@ X window ε{,
   ̥n䴩 XIM wA~౵Ӧ XIM server rJC

   xcin-2.5 O@ XIM server, ΥH XIM client  (p Big5  GB
   X) JCb@Ӱ椤 X Window tΤ (X Display), iHPɶ]nX
   XIM server, C@ XIM server @հߤ@ñӰѧO: (LC_CTYPE,
   XIM_name) C䤤 LC_CTYPE Y locale WAҦpڭ̥ΪO "zh_TW.Big5",
    XIM_name h xcin Ub X Display  XIM server WCb locale
   ҤA@ locale iH]hӥHP XIM_name Ұʪ xcin, GpGz
   nPɿJ Big5 P GB rAz} rxvt AO]w zh_TW.Big5
   P GB  locale, MOHP XIM_name Ӷ] xcin, hH zh_TW.Big5 
   locale _ʪ xcin K|H Big5 /JAϤH GB locale _ʪ 
   xcin K|H GB /JC

   PzAC@ XIM client (p rxvt) Ұʮɤ]Pɳ]w locale PƱ
   Pإ߳su XIM server W (Y XIM_name), pAb zh_TW.Big5 locale
   UҰʪ XIM client NiHӦ zh_TW.Big5 locale UҰʪ xcin 
   JA GB locale pMC

   bw]pUA xcin YOb zh_TW.Big5 locale UҰʪAhҵU
   XIM_name  "xcin" CYObO locale UҰʡAҦp: zh_CN.GB2312, h
   ҵU XIM_name  "xcin" YA[ -"locale W"AҦp:

	xcin-zh_CN.GB2312

   MAڭ̤]iHbROCﶵϥ -x ﶵӫw xcin ΨӵUWrC

   ~AзǪ XIM server ٥iH䴩ƺؤP input_style, ӥثe xcin
   u䴩@ input_style: "Root", YզrϻPAϥb xcin C
   ]znҰ XIM client P xcin suɡAz]w client  input_style,
    xcin |A䴩L input_styleC

    xcin ҰʮɡAҦWz XIM server պA|ܥXӡAH XIM client
   ]wɰѦҡAҦpbw]pUҰ xcin ([ﶵ)Ah xcin |LX
   pUT:

XCIN (Chinese XIM server) version xcin <version number>.
(module ver: <version number>, syscin ver: <version number>).
(use "-h" option for help)

xcin: XIM server "xcin" locale "zh_TW.Big5" transport "X/" inp_style "Root".

   NqO: XIM_name  "xcin", locale (LC_CTYPE) Ҭ "zh_TW.Big5", XIM
   ǿҦO "X protocol",  inp_style  "Root"C

   xcin PɱĥΰʺAs覡P XIM client B@Cڭ̥Ρu^ơvBubΡv
   JɡA xcin P XIM client OBu_uvAAGڭ̿JO@
   ascii XCڭ̫U@Ĳo (trigger keyAԨz) ɡAN
   _F XIM client P server suAӶi椤ΥΦrJC



3. rcfile 榡 (ЦPɰѦ xcinrc ):

   xcin-2.5  rcfile ĥ siod ykRAyk lisp/Scheme V
   XCykpU:

   a. p@椤 ';' rAhqr}l@楽|`ѡC

   b. (define $cmd $value):
	]w $cmd Ȭ $value CY $value ȥuO¦rAhΤ@
	޸ " A_ӡCҦp:

	(define FG_COLOR "white")	; ]we⬰զ

	$value ]iHOU@h $cmd, $value lAhoǤl~򥲶
        A[@hAAҦp:

	; ]wJk zh_hex 䤤W "Big5 X"AB BEEP_WRONG Ȭ
	; "YES" CЪ`NHUAtC
	(define zh_hex  '((INP_CNAME   "Big5 X")
			  (BEEP_WRONG  "YES")
		         )
	)
        
   xcin-2.5 [c xcin D{PJkҲ (module) ⳡC rcfile
   ]wT`: D{]wBD{U locale ]wBHΦUJk
   ӳ]wC䤤UJkӳ]wPӿJkҮMΪҲզAԲӤe
   аѦ doc/modules/ CHU xcin D{ rcfile command 
   rNq ( xcinrc ):

 
   a. D{]w:
   ------------------
   XCIN_DEFAULT_DIR:
	xcin w]ƥؿAӥؿsJkBJkҲաBΨLɮסC

   XCIN_USER_DIR:
	ϥΪ̦۩wƥؿCYO|AhOHϥΪ $HOME ؿ}lC

   INDEX_FONT:
	Ψܭ^JkW ( xcin kU) rWC

   FG_COLOR:
	xcin eC

   BG_COLOR:
	xcin IC

   M_FG_COLOR:
	xcin Sܫe (pզrϡBЦr)C

   M_BG_COLOR:
	xcin SܭI (pզrϡBЦr)C

   X_GEOMETRY:
	xcin }ҪjpBmC

   XCIN_HIDE:
	O_b^PbοJ xcin?

   XKILL_DISABLE:
	O_Nuib Window Manager U xcin v\?

   IM_FOCUS_ON:
	w]ҰʿJkw\AԨzC


   b. D{U locale ]w:
   --------------------------
   boءAzC@ӱz|Ψ쪺 locale O]wAyk:

	(define "locale name"   '(( "detailed settings" ....)))

   Ҧpz|Ψ zh_TW.Big5 P zh_CN.GB2312, hzb xcinrc ]wݰ_ӷ|
   o:

==========================================================================
	(define "zh_TW.Big5"   '((cmd1  "value1")
				 (....  ........)))
	(define "zh_CN.GB2312" '((cmd1  "value1")
				 (....  ........)))
==========================================================================

   HUЩҦrPNq:

   FONTSET:
	locale һݪrժrW (B^rU@)C

   DEFAULT_IM:
	w]JkWC

   DEFAULT_IM_MODULE:
	w]JkҲզWC

   DEFAULT_IM_SINMD:
	w]Jkr (sinmd) W١CzbJɡACJ@
	rAh xcin ĤG檺kb|X{zҿJrCӳo
	ﶵNOΨӳ]wܪ覡CYO]w@ؿJkWɡAhޱz
	쨺@ӿJkA|Hzҳ]wJkWܡCYO]w 
	"DEFAULT" ɡAh|HzثeҥΪJk (zJkɡA
	ܤ]|̤)C

   CINPUT:
	wpJJkC

   PHRASE:
	wֳtyɡCֳtyJY shift+alt+?, 䤤 ? O
	@ ASCII rAҦpnXyڭ̷| shift+alt+i C

   CINPUT:
	w locale UϥΪJkW١C


   c. UJkӳ]w:
   ----------------------
   ҿסuJkW١vNOJkWAh ".tab"  ".cin"
   ɦWAҦpڭ̱`ܾeJkY "cj", `JkY "phone"C 
   {b xcin Awʫw ctrl+alt+3 O`B ctrl+alt+6 OFAҦ
   ݭnΪJkA CINPUT ]w~|JϥΡC DEFAULT_IM P
   DEFAULT_IM_SINMD ҫwJkWAbҦ CINPUT ]wo~
    (䤤 DEFAULT_IM_SINMD Yw "DEFAULT" ɨҥ~)AY䤣A xcin |
   ۰ʿΨL CINPUT ҫwJk@w]JkΧ@w]rܥΡC

   PLht@ӫܤjPIOA xcin ĥΤFJkҲ (module) [cC
   JkPҲժY: JkOAӼҲիhO˪ (ήM)C²ӻA@
    .cin ( .tab) ɴNO@ӿJkAp cj.cin, ӿJkǥѼҲթ
   Ѫ禡~u@A]NOuNJkMJҲդvC]A@ӼҲեiHM
   hӿJkAҦp gen_inp ҲաAiHMΥثe`ΪJkpܾeBCB
   L̡Bj .... CӯSJkALk gen_inp ҲըӮMΪA
   ~t~g@ӱMҲաApX (zh_hex)B` (phone) .... CGNWz
   ]wA DEFAULT_IM_MODULE NOww] module MҡCY᪺Jk
   ӳ]wASOwnMΨ@ module ܡAh DEFAULT_IM_MODULE
   ҫw module WӮMΡC

    rcfile FWz]wAUӫKOnҦb CINPUT wnϥΪ
   Jkӳ]wFC榡pU (|):

============================================================================
(define zh_hex 				; oO CINPUT C䤤@ӿJkW
        '((INP_CNAME    "Big5 X")	; HUOJkӳ]w
          (SETKEY       0)
          (MODULE       zh_hex)
          (......	......)))

(define cj
        '((SETKEY       1)
	  (......	......)))
============================================================================

   UiHAҦJkӨB]wOӦۿWߪAG|ª xcin 
   ˡA@ӿJkӳ]wAhҦJkvTCCӿJkӳ
   ]wӸ`ĄҮMΪ module ӦPAШ modules/ ؿ
   UҲժCHUUҲէiϥΪӳ]w:

   1. INP_CNAME:
	]wJkWAiiLCO_ĥΦ]wh module 
	@өwC

   2. SETKEY:
	wqӿJkApX ctrl+alt+0, ܾe ctrl+alt+1C

   3. MODULE:
	wJkMΪ module WCYwAh|H DEFAULT_IM_MODULE
	ҳ]w module ӮMΡCЪ`NAëDҦ module iHMΩҦ
	JkAҦp zh_hex module uM zh_hex JkAளӮMέ
	eJkCGpGzFwANiyMΥѡAh xcin |
	ĵiTAéJkC

   ҦJkP module u|bݭnɤ~JAGϥΪ̥iHb rcfile ]w
   5, 6 ӿJkAuϥΪ̯u|Ψ쪺 (Y ctrl+alt+? 쪺)
   XӤ~|uJ)C

   ҦM locale ɡA]AҦ .cin, .tab, HΧֳtyJ
   ɵAw]Ob $XCIN_DEFAULT_DIR/tab/$LC_CTYPE/ ؿAϥ
   ̤]iHۦǳƱz .cin P .tab ɡAbz $XCIN_USER_DIR ؿ
   (Ҧp $HOME/.xcin/), xcin ҰʮɷjMoǸɪǬ:

	1. $XCIN_USER_DIR/tab/$LC_CTYPE/
	2. $XCIN_USER_DIR/tab/
	3. $XCIN_USER_DIR/
	4. $XCIN_DEFAULT_DIR/tab/$LC_CTYPE
	5. $XCIN_DEFAULT_DIR/tab/
	6. $XCIN_DEFAULT_DIR/



4. Trigger keys & Special keys:

   Trigger keys ΨӡuĲov XIM client P XIM server su:

   a. ctrl+space:   / ^C

   b. ctrl+alt+[0123456790-=]:  ܿJkC

   c. shift+space:   / bΤC

   d. ctrl+shift:  ̧ǤJk (V)C

   e. shift+ctrl:  ̧ǤJk (ϦV)C


   bPɬJPμҦAYVJr䤣OӿJkզrAh
   βŸXCYOӿJkզrAYPɫU shift ɡAh:

   a. Y CapLock off, hXpgέ^C

   b. Y CapLock on, hXjgέ^C


   LS䬰:

   a. ctrl+alt+r iHЦ XIM client JrC

   b. ctrl+alt+i iH`ǤJkr (sinmd), Y DEFAULT_IM_SINMD
      O]w "DEFAULT" ɡAhUS "DEFAULT" ҦYC

   c. ctrl+alt+f iH}ҡBJkw\CJkw\}ҮɡA
      xcin kUJkWe|h@ "*" C\}ҮɡAC
      sε{Ұ (Ys IC )Ahε{|۰ʶiJثe
      wJkAӤ|Hw]^ƿJҰʡCzbJkɡAw
      Jk]HܡC

      (\઺ޤJAOF xcin බQb netscape-4.5/6 UJAԨ
       FAQ )


5. U module ӳ]wAШ modules/ ؿC


T.H.Hsieh
