INTRODUCTION

 This is a libvnckbemu - a LD_PRELOAD thingy that substitutes XLookupString
 and does what XLookupString should for converting KeyEvents to strings.
 This is the only solution I see (beside recompiling Xlib) to allow Xvnc to 
 input russian, since Xvnc doesn't support xkb extension.
 
 There are 3 charsets compiled in - cp1251, iso*5, koi8ub (koi8-r plus
 ukrainian and byelorussian letters). Each of them supports (AFAIR) all 
 russian, ukrainian and byelorussian letters, so it seems this is the ultimate 
 solution for those 3 languages.


	COMPILING
	
 Just typing 'make' and then as root 'make install' should install this library
 in most typical case - the library will be installed into /usr/local/lib. 
 But the library needs to be activated, so read forth.
 
 
	ACTIVATION
	
 To activate this library, it should be added to the list of preloaded libraries,
 i.e to LD_PRELOAD environment variable. If your /etc/profile sources every file
 in /etc/profile.d, then you can safely copy the vnckbemu.sh to that directory, 
 otherwise insert something like     
     LD_PRELOAD=${LD_PRELOAD}:/usr/local/lib/libvnckbemu.so.1
     export LD_PRELOAD
 into your profile. It's safe to unconditionally preload this library since it
 will be activated (if you don't order it to behave otherwise) only for
 Xvnc servers. Make sure that your dynamic loader supports $LD_PRELOAD (this 
 env variable is definitely supported on Linux and Solaris). Note: this
 library should be preloaded on the machine where X clients (i.e. programs) are
 running, not Xvnc or vncviewer.
 
 
     ENVIRONMENT VARIABLES
     
 Beahviour of this library can be affected by following environment variables:
 
 VNCKBEMU_DISABLE: If present, this library just redirects to everything to the
                 real XLookupKeysym.
 VNCKBEMU_TRACE: if present, independant of value, tracing messages will be 
                 printed on stdout
 VNCKBEMU_ANY_XSERVER: If present, then it will be activated for any X server,
                 not only for Xvnc.
 VNCKBEMU_FORCE_ENCODING: If present, its value is used as name of current 
                 encoding. It can be one of "cp1251","koi8ub","iso5","unknown".
                 This is useful if LC_CTYPE category doesn't correspond to 
		 current locale.

 If none of these environment variables are set, the library will try to guess
 client's encoding. Autodetection shouldn't fail if your LC_CTYPE category
 corresponds to your locale.
 
 
     MISC

 There are other patches by me to VNC family of software. Here is a (possibly
 incoplete) list of them:
 
     * Patch to vnc viewer for Windows that allows input of russian text
       into X apps running via Xvnc. Without it, no russian letters can be typed
       using vncviewer for Windows.
       
     * Patch to Xvnc to improve support for non-latin1 letters. Applying this pact
       is not required in order to be able to input cyrillic letters. That
       patch lets Capslock key to be correctly handled when non-latin letters
       are being typed (if it's not applied, you'll get lowercased russian 
       letters independant of state of Capslock key).
 
  All these (and possibly more) patches are available on 
  http://hvv.pp.ru/vnc/


     AUTHOR
     
 (c) by Vlad Harchev <hvv at hvv pp ru>
 Distributed under GPL.
   Bugfixes, comments are welcome. 
   Donations (including money, books, CD, discounts but not limited to) are 
 very appreciated, especially from corporate users of this library to support 
 cyrillizing free software. 
   Linux distributions' authors are asked to mail boxed versions of their 
 distributions that include this library to me.
   Commercial support for this library and other patches is available.