MAN page from RedHat Other cxterm-color-5.0.p3-2.i386.rpm

TIT2CIT

Section: User Commands (1)
Updated: CXTERM Version 5.0
Index

NAME

tit2cit, cit2tit - Input method compiler for cxterm

SYNOPSIS

tit2cit[file]
cit2tit[file]

DESCRIPTION

Input methods for cxterm are stored as external filesand are loaded by cxterm in runtime on demand.Input method files have two formats, text format and compiled format.

Text format has suffix .tit (tit for Text Input Table) in the file name,and is intended to be read and written by human; compiled format hassuffix .cit (cit for Compiled Input Table) in the file name,and is loaded by cxterm. Utilities tit2cit and cit2titconvert input method files between these two formats.

If the file argument is given to the tit2cit or cit2tit,the input is taken from the file, otherwise the input is from stdin.Both programs write the input table to stdout.

TIT FILE FORMAT

A .tit file is a line-oriented text (English and Chinese) file.The whole file contains of two parts, the definition part followed bythe dictionary part.All lines begin with leading '#' are ignored. Then each line consists ofone keyword and followed by zero or more definitions. In the followingformal specification,

<key> means any character with ASCII code from 0 to 127, if notprintable, the character should be in \ooo format, where ooo isthe ASCII code in 3 octal-decimal digit form;

<keys>means a continuous string of <key>;

<string> means any string of ASCII characters (unprintable in )and Chinese characters;

<Cstring> means string of Chinese characters;

\000 indicates an empty field.

DEFINITION PART

Each line is consisted of a keyword and followed by optionaldefinitions:

ENCODE: <string>

Define the encoding of the input method.Valid values of <string> are GB, BIG5, JIS, and KS;the default is GB.

AUTOSELECT: <string>

Specify whether a Chinese character should be automatically inputwithout a selection key,when it is the only candidate of a given input string.Valid values of <string> are NEVER, ALWAYS, or WHENNOMATCH;the default is NEVER.

PROMPT: <string>

Define prompt string to be shown in the cxterm input area.Valid values of <string> are any Chinese and English mixed stringshorter or equal to 24 bytes. There is no default value for this prompt.

VALIDINPUTKEY: <keys>

Specify all the valid input keys that can be used in the input string of aChinese character. There is no default valid input keys.

WILDCARDKEY: <keys>

Specify the keys for use to match any number of input keys in Chinese input.The default value is "*".

WILDCHARKEY: <keys>

Specify the keys for use to match any single input key in Chinese input.The default value is "?".

ASSOCIATIONKEY: <keys>

Specify the keys for use in association phrase input by composition.The default value is "-".

SELECTKEY: <keys> <keys> ...

Specify the keys to be used in Chinese input selection. They must bein same order of the choices shown on the input area.The number of sets of keys <keys> can not exceed 16.The default value is

        SELECTKEY: 1\040 2 3 4 5 6 7 8 9 0

MOVERIGHT: <keys>

Specify the keys to be used to show more choices at the right.The default value is ".>"

MOVELEFT: <keys>

Specify the keys to be used to show more choices at the left.The default value is ",<"

BACKSPACE: <keys>

Specify the keys to be used for backspace in Chinese input area. The default value is "\010\177" (Backspace, Delete).

DELETEALL: <keys>

Specify the keys to be used to clear all input in Chinese input area. The default value is "\015\025" (Return, CTRL-U).

CURSOR-BEGIN: <keys>

Specify the keys to move the cursor to the beginningof the input keystroke buffer.There is no default cursor movement key.

CURSOR-END: <keys>

Specify the keys to move the cursor to the endof the input keystroke buffer.There is no default cursor movement key.

CURSOR-FORW: <keys>

Specify the keys to move the cursor forward one keyin the input keystroke buffer.There is no default cursor movement key.

CURSOR-BACK: <keys>

Specify the keys to move the cursor backward one keyin the input keystroke buffer.There is no default cursor movement key.

CURSOR-ERASE: <keys>

Specify the keys to delete the input key at the cursor position.There is no default cursor movement key.

REPEATKEY: <keys>

Specify the keys to be used to repeat the input of last selection.The default value is "\020\022" (CTRL-P, CTRL-R).

KEYPROMPT(<key>): <string>

Define corresponding <string> to be displayed in input area whenthe key <key> is input.Maximum length of each <string> is 4 bytes.Default value of <string> is the <key> itself.

COMMENT anything

Any thing follows COMMENT will be saved at the end of the .cit file.

DICTIONARY PART

The dictionary part contains optional hanzi dictionary and phrase dictionary.

The hanzi dictionary starts with BEGINDICTIONARY.Each lines in the hanzi dictionary is in the form of:

        <keys>  <Cstring>

Each individual Chinese character in <Cstring> can be input by key sequence <keys>.

The phrase dictionary starts with BEGINPHRASE.A phrase is a unit of multiple Chinese charactersand is input together as a whole.Each lines in the phrase dictionary is in the form of:

        <keys>  <Cstring> <Cstring> ...

Each <Cstring> can be input by key sequence <keys>.

BUG

cit2tit is not an exact reverse of tit2cit.

COPYRIGHT

This document was created byman2html,using the manual pages.