to conserve space, fonts are archived separately in ftp://ftp.ifcss.org/pub/software/fonts/gb/bdf/ if you use X11R6, it is already has Chinese GB fonts installed. Nelson for ftp-admin@ifcss.org --- Wide X Window(TM) Tryout Release by MicroObject Ltd. WELCOME TO WIDE X WINDOW , A COMPLETE CHINESE GUI ON X Wide X Window ver.1.2 Copyright 1993, 1994, MicroObject Ltd. All rights reserved Table of Contents 1. About Wide X Window 2. About WxW tryout release 3. How to install 4. IME usage 5. IME operation guide 6. How to customize 7. Bug report 8. Acknowledgements 1. About Wide X Window What is NEW ? 1). Complete Chinese support Wide X Window can handle simplified Chinese(used in mail land) and traditional Chinese(used in Taiwan and Hongkong) . It brings you not only a platform for localization of many original applications based on X-window , but also a perfect environment for developing Chinese applications . 2). Compatiable with X11R5 Wide X Window is compatiable with X11R5 . Almost all applications developed on Xaw or Motif 1.2 such as xedit, xmh, xmpostit, etc. can process Chinese as well as English without any change . 3). Use IME(Input Methold Engine) to handle Chinese input Based on Client/Server model , all Chinese input is done by a special X client called IME for WxW . 4). Support most important Chinese input methods They can be customized and rebuilt also . The following input methods are built in now : GB code(simplified Chinese used in main land) : 1) QuanPin input method 2) ZhuPin input method 3) WuBi input method 4) QuanJiao(double-byte ASCII in GB code) input method 5) GB code input method BIG5 code(traditional Chinese used in Taiwan and Hongkong) : 1) QuanPin input method 2) ZhuPin input method 3) QuanJiao(double-byte ASCII in BIG5 code) input method 5). One key to switch IME Wide X Window use a special key as an IME switch to switch on/off IME . This key can be redefined also . 6). IME's layout can be customized Support both input bar mode(off the spot) and system line mode(root) . Support OS Wide X Window ver.1.2 is available on the following OS : SunOS 4.1.x, Linux, EWS 4800 , etc. Information For further information , please contact : Gary Liu 204, SUGENOTORO 15-10 TAMA-KU , KAWASAKI SHI Japan 214 Tel (81)44-946-0744 email: jul2@lehigh.edu 2. About WxW tryout release This tryout release of WxW is in gz format , including IME for WxW and some sample X clients on WxW . The programs in this package are statically linked with WxW library , which is an internationalized Xlib supporting Chinese developed by MicroObject Ltd . All these programs can handle Chinese as well as English . They are : ime IME for Wide X Window (Copyright 1993, 1994, MicroObject Ltd.) twm Tom's Window Manager (Copyright 1988, Evans & Sutherland Computer Corporation, Salt Lake City, Utah) xmh X window mh-mail (COPYRIGHT 1987, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS) xedit X window text editor (COPYRIGHT 1987, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS) cterm Chinese terminal on X (Copyright 1993, 1994, MicroObject Ltd.) celvis Chinese version of "elvis" ---- a vi/ex clone (original by Steve Kirkendall , Chinese version by Man-Chi Pong, Yongguang Zhang) All binary code is for SunOS 4.1.x . 3. How to install ? You should install it like the following : 1) Convert it to tar file : gzip -d wxw_tryout.tar.gz 2) Extract WxW tryout programs from tar file : tar xvf wxw_tryout.tar and then you get the following file structure in your current directory : wxw_tryout/README (release note) wxw_tryout/run/ime (IME for WxW) twm (window manager) xmh (e-mail) cterm (Chinese terminal) celvis (Chinese vi) xedit (pointer oriented text editor) system.twmrc.gb (twm configuration) Xmh.ad (resource file of xmh) CTerm.ad (resource file of cterm) Xedit.ad (resource file of xedit) wxw_tryout/dict/ (dictionaries) wxw_tryout/fonts/ (fonts) wxw_tryout/locale/ (locale setting) 3) Read README file for help 4) This tryout release supports only C and china(GB code) locale . If current locale on your computer is not above , set locale to C like : setenv LANC C 5) Suppose you install WxW tryout release in $HOME/wxw_tryout , then set dictionary path like : setenv CHINESE_DICTIONARY_DIR $HOME/wxw_tryout/dict set I18N path like : setenv XLIBI18N_PATH $HOME/wxw_tryout/locale add font path like : xset +fp $HOME/wxw_tryout/fonts add shell path like : set path=($HOME/wxw_tryout/run $path) 6) If necessary , customize WxW (see How to customize ?) 7) Suppose you install WxW tryout release in $HOME/wxw_tryout , then set resources like : xrdb -merge $HOME/wxw_tryout/run/Xmh.ad (set resource of xmh) xrdb -merge $HOME/wxw_tryout/run/Xedit.ad (set resource of xedit) xrdb -merge $HOME/wxw_tryout/run/CTerm.ad (set resource of cterm) 8) Execute WxW tryout programs : use twm(window manager) of this release , and then execute other programs from twm's menu : twm -f system.twmrc.gb & or not use twm , just execute other programs one by one : ime -switch F1 & xedit & xmh & cterm & At last , execute celvis on cterm . 4. IME usage IME for Wide X Window Usage : ime [-display name] [-switch keysym] [-fg foreground] [-bg background] [-fn ascii_font_name] [-gbfn gb_font] [-prompt_space n] [-preedit_space n] [-col_space n] [-reverse] [-autosaveoff] [-systemline] [-help] -display name : X server name -switch keysym : IME engine switch , keysym is a Keysym name, which should be gotten by deleting XK_ of a Keysym for example , F1 stands for XK_F1(Function key 1) In default , Multi_key(Compose key) is current IME switch . -fg foreground : foreground color -bg background : background color -fn ascii_font_name : ascii font name used in IME -gbfn gb_font_name : GB font name used in IME -prompt_space : spacing between prompt and preedit_area -preedit_space : spacing between preedit_area and candidates_area -col_space : column spacing in candidates_area -reverse : video reverse -autosaveoff : stop autosave of dictionaries -systemline : force input bar to be displayed on the bottom of sceen -help : display usage of IME 5. IME operation guide Keyboard operation can be done in application window as well as in IME input bar , and you should do it in application window when convert . 1) Turn on/off IME Function Operation Turn on/off IME type current IME switch key . If IME is on , it will be off , If IME is off , it will be on . When IME is on , it is displayed as an input bar under current focus window and you can input Chinese in this application . Otherwise it is displayed as an icon named "IME Ready" and you can input ASCII string as usual . 2) Input Chinese when IME is on Function Operation Input character type [a-z] , if with tone , also [1-4] for example input "zhongguo" . Delete last character type key Backspace or Delete Cancel type Ctrl+k to cancel current conversion Convert type Return to confirm current conversion Select and Convert type [0-9] to select a candidate and confirm Select select a candidate by moving cursor : previous row KP_Up or Ctrl+p next row KP_Down or Ctrl+n back KP_Left or Ctrl+b forward Space or KP_Right or Ctrl+f head Ctrl+a end Ctrl+e Round type Tab to round input string into its full length AI help type Ctrl+h to replace input string with any similar string . For example , "zongguo" and "zhongguo" are similar . The following rules are used in replacing : c<->ch, s<->sh, z<->zh, en<->eng, in<->ing (Note that this is available only when using QuanPin or ZhuPin input methold) Repeat type Ctrl+y to yank previous conversion into current preedit area Change input methold type Ctrl+m to switch to next input methold Change codeset type Ctrl+Shift+m to switch to next codeset (Note that this function is not available in WxW tryout release) Register a new word type Ctrl+Shift+r to switch on/off registration mode Remove a word type Ctrl+Shift+d to switch on/off remove mode Quit IME type Ctrl+Shift+q to exit Mouse operation is available in IME input bar . Function Operation Change input methold button pressed on prompt of IME input bar Popup help message button pressed on help(??) of IME input bar Select button pressed on candidate of IME input bar Turn on/off IME button pressed on other area of IME input bar [NOTE: Ctrl+m means pressing Ctrl and m simultaneously , Ctrl+Shift+m means pressing Ctrl , Shift and m simultaneously .] 6. How to customize ? 1) Rebuilt input metholds Input metholds are built into IME according to file dic.dir which is in WxW's dict directory with dictionaries . To rebuilt input metholds , quit current IME , and modify dic.dir file like the following : 1. if an input methold is no longer needed , mark it comment by inserting a # at the begining of the entry . 2. if an input methold is needed , delete the # at the begining . After modification , restart IME . 2) Redefine IME switch In default , Multi_key(Compose key) is current IME switch . If your X server has not this key or you want to assign another key , quit current IME , and restart it like : ime -switch another_key & Note that IME engine switch should not be used for other purpose . for example , Keys listed in IME operation guide such as a-z , 0-9 , Ctrl, Shift , BackSpace , Delete and etc. should be avoided . Function key is recommended to be used as IME switch . for example ime -switch F1 & (assign Function key 1) 3) Change IME layout policy In default , IME uses input bar layout policy . To switch to system line mode , quit current IME , and restart it like : ime -systemline & 4) Update dictionaries In default , IME updates dictionaries automatically . To stop this auto saving , quit current IME , and restart it like : ime -autosaveoff & 7. Bug report Please report any bug to jul2@lehigh.edu , thanks . 8. Acknowledgements This tryout release of WxW is brought you by MicroObject Ltd. CND and many individuals have cooperated and worked extremely hard to make this release possible . We cannot possibly acknowledge them all here . We greatly appreciate the work that everyone has put into this release , our thanks go out to them . Jun Liu Bin Song Jian Liu Liedong Zheng X Window System is a trade mark of X Consortium . Wide X Window is a trade mark of MicroObject Ltd . Hope you enjoy Wide X Window !