--- /dev/null
+<HTML><HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=koi8-r">
+<TITLE>Russian layout for xvkbd</TITLE>
+<meta name="description" content="Russian layout for xvkbd on-screen
+keyboard">
+</HEAD><BODY>
+<H1>Russian layout for xvkbd</H1>
+<p>
+<a href="http://homepage3.nifty.com/tsato/xvkbd/">xvkbd</a> is a piece
+of software useful for keyboard-less computers such as PDA or
+web-tablets. It includes layouts for some languages, but no Russian
+among them. But xvkbd is highly customizable via X resources
+</p>
+<p>
+So, I've written my own keyboard layout for xvkbd. Download <a
+href="XVkbd-russian">XVkbd-russian</a> file and use it as described
+in xvkbd manual.
+</p>
+<p>
+It is recommended to turn on "Lock AltGr" menu option in xvkbd
+(I've found no way to turn it on from resource file, but xvkbd would
+remember your settings).
+</p>
+<p>
+This file assumes that xvkbd is running with <b>ru_RU.KOI8-R</b> locale.
+If you want to run it in different locale, just recode filename and fix
+font charset in the first lines of file. <b>Note</b> version of xvkbd
+provided in Debian stable (2.6) is not able to display Cyrillic key
+lables correctly if they are UTF-8. So, don't run xvkbd in
+<b>ru_RU.UTF-8</b> locale, even if rest of your X application use that
+locale. This layout produce correct X keysyms, so cyrillic letters would
+be entered properly even if xvkbd and application run in different
+locales.
+</p>
+</BODY>
+</HTML>