lewtds' notes:
   
   Dự án này cơ bản là một bộ gõ tiếng Trung dạng table của tác giả T.H.Hsieh
   được bổ sung thêm các bảng định nghĩa cách gõ tiếng Việt trong thư mục
   `cin/vi` và các script để launch các ứng dụng hay dùng như gedit với các
   biến môi trường riêng về font và encoding trong thư mục `vietnam`.

*************************************************************************

        Ðây là hướng dẫn cài đặt cho XVIM version 0.2
                                      
   Ðây là version thử nghiệm nên còn nhiều thiếu sót và
   bất tiện, mong các bạn cùng chung sức phát triển nó.
   Xvim cũng như xcin là open sources, distributed theo GNU/GPL
   license. Do đó các bạn cứ download, modify, develop nó thoải
   mái theo ý bạn.
   
   Thư Góp ý xin gửi về dhson@thep.physik.uni-mainz.de.
   
   **********************************************************************
   *
   
   * Special Thank to T.H.Hsieh (thhsieh@linux.org.tw), one of the
   authours
   * of X-CIN, for his special supports.
   * Without his helps, I didn't dare to start this project.
   * Thank to Bruno Haible and other experts of XFRE86/i18n project.
   * Thank to my friends at VieLUG encouraged me to do this,
   * Mr. Nguyễn Ðại Quý, Lại Hoài TRiết, Hàn Thế Thanh et al.
   
   **********************************************************************
   *
   
   A. CÀI ÐẶT
   
   $ cd /tmp
   $ tar xvzf xvim-0.2.tar.gz
   $ cd xvim-0.2
   $ ./configure --disable-bimsphone --disable-debug --prefix=/path/to/xvim
   
   Với /path/to/xvim là nơi bạn muốn binary file sẽ
   được install. (Ví dụ như /usr/local/xvim chẳng hạn)

   Trong phần tiếp sau tôi giả sử bạn chọn --prefix=$HOME/xvim.
   Option --disable-bimsphone cần được type đúng nguyên như
   thế. Option này dùng cho Chinese input method, ta cần 'turn off' nô
   
   $ make
   $ make install
   
   Lúc này thư mục $HOME/xvim sẽ được khởi tạo.
   
   B. Configurate trước khi chạỵ
   
   1. Bạn phải chuẩn bị 1 số biến môi trường cần thiết để các
   apps nhận ra xvim. Bạn phải chuẩn bị các font cho TCVN,
   bạn nên dùng type1 font có thể download tại VietLUG hay trong
   site này.
   
   2. Edit file $HOME/.Xresources, 
   thêm các hàng sau đây cho Netscape Composer và xedit:
   
   xtDefaultFontSet: -tcvn-*-16-*-iso8859-1,-dobe-*-iso8859-1
   xedit*international: True
   xedit*fontSet: -tcvn-*-16-*-so8859-1, -adobe-*-16-*-iso8859-1
   .Xedit.shellext.inputMethod: xvim
   .Xedit.shellext.preeditType: Root
   Netscape*useStderrDialog: False
   Netscape*preeditType: Root
   
   Ở trên tôi giả sử bạn đã có font với tên là tcvn, tôi
   không nhớ rõ đây là tên default do anh Thanh (VietLUG) đặt
   hay do tôi modify. Nếu bạn gặp khó khăn về font, bạn có
   thể Email cho tôi (dhson@thep.physik.uni-mainz.de) hay post lên
   mailing list của VietLUG hỏi anh Thanh (recommended :-)))
   
   Configuration cho XEMACS bạn coi thêm trong thư mục
   xvim-0.2/doc/en/UserGuide.*
   
   3. Open 1 xterm, các lệnh tiếp sau ta sẽ làm việc và lunch
   các apps trên/từ xterm nàỵ
   
   $ export LC_CTYPE=en_US
   $ export XMODIFIERS="@im=xvim"
   $ $HOME/xvim/bin/xcin -x xvim &
  
   Hoặc đơn giản hơn có thể sử dụng script 'xvim' :
   
   $ xvim
    
   Bạn sẽ thấy thông báo như sau:
------------------------------------------------------ 
	X-VIM (X-Vietnamese Input Method)
	Version xcin 2.5.2.1.

	xcin: Locale="en_US" Encoding="iso-8859-1"
	xcin: XIM Server="xvim" Transport="X/"
	xcin: inp_styles = "Root" "OverTheSpot"
------------------------------------------------------
   
   Bây giờ bạn hay run 1 editor nào đó TỪ cùNG Xterm bạn issue
   lênh export ở trên để test. Tốt nhất và dễ nhất là
   "gedit" nếu bạn dùng GNOME và chọn font Tiếng Việt. Nếu
   không bạn có thể run "xedit", tôi nghĩ default là có trong
   Linux box của bạn. Tệ hơn bạn có thể run Netscape/Edit page.
   
   Nào bây giờ đưa cursor vào cửa sổ và chuyển qua tiếng
   Việt bằng cách nhấn kép Ctr+Spacebar. Khi này control window
   sẽ có chữ VN. Switch "Ctr+Spacebar" 1 lần nữa sẽ trả về gõ
   tiếng Anh.
   
   Bạn đã sẵn sàng để gõ tiếng Việt rồị
   
   C. CÁCH GÕ
   
   Bạn gõ theo luật Telex, tôi không chắc tôi nhớ đúng
   luật Telex nên thiết lập luật gõ như sau:
   á = as
   à = af
   ả = ar
   ã = ax
   ạ = aj
   â = aa
   ă = aw
   ô = oo
   ơ = ow
   đ = đ
   ư = w
   ect....
   
   Nếu bạn thấy chưa đúng luật gõ Telex thì mail cho tôi nhe:-)
   
   Ðể chuyển qua lại giữa telex, VNI, VIQR:
   Ctrl+Alt+1  để gõ  kiểu TELEX
   Ctrl+Alt+2 để gõ  kiểu VNI
   Ctrl+Alt+3  để gõ kiểu VIQR.
   
   Vì đây là bản thử nghiệm nên sau khi gõ tổ hợp phím
   (eg. as) bạn cần nhấn phím spacebar  trên bàn phím để
   chấp nhận, sau đó ký tự sẽ được commit cho IM và pass
   qua cho apps. Ðây là TODO của version saụ
   
   Với Netscape Composer, bạn có thể cần phải switch qua Telex
   mode bằngCtrl+Spacebar sau đó Ctrl+Alt+f để focus lên apps.
   
   Ðây là bug của netscape. Well. Bạn có thể thử với các
   apps khác và nếu thành công thì mail lên VietLUG cho anh em
   biết nhé.
   Hi vọng là "xvim" sẽ hữu dụng cho các bạn.
   
   VÀ NHỚ: Email cho tôi nếu các bạn muốn tham gia project hay
   thấy điều gì thiếu sót. Tôi muốn được trao đổi
   với các bạn theo đúng tinh thần của OPEN SOURCE.
   T.H.Hsieh đã giúp tôi theo đúng tinh thần này và tôi cũng
   muốn mang nó ra share cùng các bạn, chỉ với 1 điều kiện
   duy nhất là: Nếu các bạn develop xvim xong thì nhớ gửi
   cho tôi 1 bản xài với :-))).
   
   Mainz, 25/10/2000
   DO Hoang Son