---
name: "xcingb"
section: "1"
platform: "linux"
package: "xcingb"
version: "2.3.02-6"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/xcingb"
---

# xcingb(1)

The Chinese Input server (GB) for the X Window System.

## NAME

xcin - The Chinese Input server (GB) for the X Window System.

## SYNOPSIS

xcin \[*options*\]

## DESCRIPTION

*Xcin* is a Chinese Input server for the X Window System. It is originally written by *Edward Der-Hua Liu*, the version of *xcin-2.1b*, package-rearranged by *Tung-Han Hsieh*, the version of *xcin-2.1c*, and highly improved by  *Suei-Jeng Wang \<vvvv.bbs@cis.nctu.edu.tw\>*, the version of  *XcinFix4*. This version, *xcin-2.1d*, is based on *xcin-2.1b*, with some features of *xcin-2.1c*, and plus the improvement of *XcinFix4*. It is intended to provide a more flexible,  more powerful, and more reliable Chinese input environment for various users.

*Xcin* is only an input-server. It should work with the display-client which is compiled with *cli\_xcin.o* module, such as *crxvt* (1).

On the start up, *xcin* will check the data files in it default search path (see *-tabdir* option). If the users start *xcin* with their favorite *UDIM* (see below), then *xcin* will try to search the data files of the *UDIM* in the following sequence:

    1\. $(HOME)\
     2\. $(HOME)/.xcin\
     3\. The value defined in $(XCIN\_DIR) in Makefile (The \
        default search path).

*Xcin* provides a lot of options to help users to configure their Chinese-input environment. However, it seems that it will be a little difficult to explain them completely in English. Therefore, this manual page only serves as a quick guideline on how to use these options. For detailed description, please referred to  *xcin.HOWTO* document with this package (In fact, this manual page is based on *xcin.HOWTO*).

## OPTIONS

There are two ways to use these options. One is appending these  options directly on the command line, such as:

xcin -in9 Boshiamy.tab -vb 2 -len 10 -inmd 9

or use the standard X-window resource file. Usually the custom  X-resource is the *$(HOME)/.Xdefault*. One can add the following lines into the resource file:

    xcin.in9:   Boshiamy.tab\
     xcin.vb:    2\
     xcin.len:   10\
     xcin.inmd:  9

and this is equivalent to the command line listed above. Note that each option has the format: *\<option name\> \<value\>*. For one example on the above, *in9* is the *option name*, and  *Boshiamy.tab* is the *value*.

Here and after we will use the following definitions:

- User Defined Input Method (*UDIM*)

  *Xcin* provides a utility *cin2tab* for users to prepare their own input-method. One can simply edit a *.cin* input-method definition file and use *cin2tab* to transform it for *xcin* (for details, please refer to *cin2tab* (1)). One can use this method to generate the input-method table such as *ChangJei*, *Array*, or *Boshiamy*. But *Phonetic*, *Phrase* *Phonetic*, *Internal Encoding* and *Phrase Library* are  internally defined by *xcin*. They are not belong to *UDIM*.

- Every *UDIM* has the *maximum encoding length*. For example,

  - Fully Input Encoding (*FIE*)

  *ChangJei* and *Array* have at most 5 codes to form a  character, and *Array* has at most 4 codes. If we should type to fill the *maximum encoding length* to generate a particular character under a particular *UDIM*, we call it is under the *FIE* state.

- The supported options are listed as following:

  - \-bg *color*

  Set the background color of *xcin* to be *color*.

- \-display *display*

  Set the remote X-server display of *xcin* to be *display*.

- \-fg *color*

  Set the foreground color of *xcin* to be *color*.

- \-font *fontName*

  Set the English font of *xcin* to be *fontName*.

- \-fngb *fontName*

  Set the Chinese (GB) font of *xcin* to be *fontName*.  Note that the width of Chinese font should be twice as that of English font. For example, if you use the *hanzigb24st* (with width 24) to be  the Chinese font, then you should better use the *12x24*  (with width 12) to be the English font.

- \-geometry *geometry*

  Set the geometry of *xcin* to be *geometry*.

- \-hidden *value*

  Set *value* to 1 to hid *xcin* when the client is under the  English input mode or focus on the X-application which is not the *xcin* client. Set it to 0 will not hid *xcin* under the  circumstance. In addition, you can also use the key set Ctrl-Alt-m to switch it to be on or off. The default value is 0.

- \-in*?* *inputName*

  Set the key sets Ctrl-Alt-*?* to be the input-method  *inputName*. The value of *?* can be 1, 2, 3, 4, 5, 6,   7, 8, 9 and 12.  Note that *-in0*, *-in11* are  preserved for internal input-methods: *-in0* is  *Enternal Encoding*, and *-in11* is *Phase Library* (see the description of *-vocbox* option).  The *-in11* and  *-in12* are special and use the Ctrl-Alt-- and Ctrl-Alt-= key sets,  respectively.

- \-inbg *color*

  Set the background color of the input region of *xcin* to be  *color*.

- \-infg *color*

  Set the foreground color of the input region of *xcin* to be  *color*.

- \-inmd *?*

  Set the default input-method to use when *xcin* starts up. The value of *?* can be one of the number 1 - 12.

- \-last\_full *value*

  When you type the *FIE* for a particular character, *xcin* will output the character directly. This option will control *xcin* to send the white space followed by *FIE* immediately or not. Set *value* to 0 will send the white space, or set it to 1 will not.

- \-len *length*

  Set the length of *xcin* to be *length*. This is the number of English characters which can be fit into the *xcin* window. It is a relative value, i.e., if *length* is zero, then the width of *xcin* can fit in 44 English characters. You can enlarge or shorten its width by assigning it to be positive or negative values. Note that its value should be greater than -43.

- \-phrase *phraseName*

  Use the key set Shift-Alt-\<one key\> will send a phrase directly in *xcin*. Use this option to set the phrase file to be  *phraseName*. The default value is *sample.phs.out*.

- \-tabdir *tabPath*

  Use this option with value *tabPath* to override the default  search path for data files and input-method tables of *xcin*. The default value is defined in the *XCIN\_DIR* variable in the compiling time.

- \-wild *value*

  If you want to type a particular character but unfortunately you can only remember parts of its encoding, you can type the encoding which you remembered with the "\*" or "?" code. *Xcin* has the  ability to list all the characters with the encodings which satisfy the wild field. Use the option to turn this ability to be on or off. If you set *value* to 1, it is on, or you set *value* to 0,  it is off.

- \-vb *value*

  Use this option to control *xcin* to beep or not. *value* can be following values:

       1 :  Only beep when you type the wrong \
             encoding.\
        2 :  Only beep when you type the encoding with \
             duplicate characters.\
        3 :  Don't beep in any case.\
        4 :  Beep when you type the wrong encoding or \
             encoding with duplicate characters.

- \-vocbox *vocName*

  Use the key set Ctrl-Alt-- will switch to the *Phrase Library* input-method. One can use this option to set the *Phrase Library* data file to be *vocName*.

## BUGS

If you find any bugs, please report to:

      *vvvv.bbs@cis.nctu.edu.tw*\
    or *thhsieh@twcpro.phys.ntu.edu.tw*.

## AUTHORS

Edward Der-Hua Liu \
      (Original author of xcin-2.1b)

Jian-Da Li \<jdli@FreeBSD.csie.nctu.edu.tw\>\
      (Contribtion on *National Phonetic* mode)

Tung-Han Hsieh \<thhsieh@twcpro.phys.ntu.edu.tw\>\
      (xcin-2.1c, xcin-2.1d package management)

Suei-Jeng Wang \<vvvv.bbs@cis.nctu.edu.tw\>\
      (XcinFix4: highly improved version of xcin-2.1b)

## SEE ALSO

[crxvt-gb(1)](/crxvt-gb/1.md), [cin2tab(1)](/cin2tab/1.md), xcin.HOWTO, cin2tab.HOWTO, Boshiamy.HOWTO, Xfonts.HOWTO