	-----------------------------------------------------
	-----------------------------------------------------
		 CYRILLIC ON LINUX CONSOLE FOR DEBIAN
	-----------------------------------------------------
	-----------------------------------------------------


			 1. THE SCRIPT `CYR'

The package console-cyrillic (upstream author: Victor Wagner
<vitus@ice.ru> <vitus@wagner.rinet.ru>) gives you easy and powerful
"cyrillization" of the Linux console.  It is recommended that you
install also the package console-tools.

For fast Cyrillic use the script `cyr'.  Try `cyr --help' for usage
summary.  First time you invoke `cyr' in this way:

cyr sr alt_shift_toggle -e iso-8859-5 -s arab -f14 --save

This sets Cyrillic on console with Serbian keyboard, working encoding
ISO-8859-5, and 14-point font `arab'.  The keyboard is toggled between
Cyrillic and Latin alphabets by Alt+Shift combination.  The option
`--save' says `cyr' to save this combination as default for the next
invoking.

After this saving it is enough just to run `cyr' without parameters.
Or you can use a command like

cyr -ecp1251

to work with your default keyboard and font but with CP1251.  Or to
play with

cyr -s lenta

and see how look other supported Cyrillic fonts.

If you want to use `cyr' with non-standard font use a command like

cyr --font=/usr/share/consolefonts/lat2-14.psf.gz


		    2. SUPPORTED KEYBOARD MAPPINGS

All keyboard mappings in the package are based on the system of
macroses developed by Cyril Slobin <slobin@iname.com>.  The package
contains the following keyboard mappings:

a) bg_bds

The Cyrillic letters in this mapping are arranged according to the
State Standard of Bulgaria.

b) bg_phon

The Cyrillic letters in this mapping are arranged according to their
phonetic transliteration with Latin Letters.  Bulgarian Apple II
clonings used KOI-7 and this made the phonetic keyboard even more
popular than the standard "BDS" keyboard.

c) by

This is a Belarusian Cyrillic keyboard mapping.

d) kaz_gost and kaz_alt

These are Kazakh keyboard mappings.  In the first the key \| produces
the symbols \ and |.  In the second this key produces the Russian
letter IO.

e) mk

This is a Macedonian keyboard mapping.

f) mn

This is a Mongolian keyboard mapping.

g) ru

This is a Russian keyboard mapping by Cyril Slobin <slobin@iname.com>.
All Cyrillic letters are on their proper places.

h) ru_ms

This is a Russian keyboard mapping by Victor Wagner <vitus@ice.ru>.
It follows the layout of the Russian keyboard in MS Windows.

i) sr

This is a Serbian Cyrillic keyboard mapping.  The arrangement of the
Cyrillic letters is according to the keyboard mapping made by Milos
Rancic <millosh@isgf.grf.bg.ac.yu>.  Note that the Cyrillic `ZH' is on
the key </ ?>, the Cyrillic `DJ' is on the key <z Z>.  In Cyrillic
mode the symbols `-' and `_' are on the key <\ |> and the symbols `['
and `]' are on the key <] }>.

j) ua

This is an Ukrainian keyboard mapping by Igor Vlasenko
<vlasenko@imath.kiev.ua>.

k) ua_ms

This is an Ukrainian keyboard mapping by Igor Vlasenko
<vlasenko@imath.kiev.ua>.  It follows the layout of the Ukrainian
keyboard in MS Windows.


		   3. SUPPORTED CYRILLIC ENCODINGS

In the terminology of the script `cyr', only the font styles `c',
`lenta', `pln', `sans', `uni', `ter-slav-*' and `ter-uni-*' contain
all letters, needed for all Slavic Cyrillic languages.  If you use
some other style (i.e. some other font) some of the Cyrillic letters
will be approximated with other symbols.  The font styles `ter-asia-*',
`ter-uni-*' `a-asia', `b-asia' and `antiq-asia' support the Asian
Cyrillic languages.

The supported Cyrillic encodings by console-cyrillic are:
Apple-Cyrillic, CP1251 (MS-CYR), IBM866 (DOS-CYR-RU, CP866),
ISO-8859-5, KOI8-R, KOI8-U, MIK (DOS-CYR-BG) and PT154 (ASIAN-CYR)
and RK1048.


                      4. CYRILLIC AT RUN-TIME

Very often when you switch to X Window and back to Linux console the
Cyrillic on console becomes broken.  Actually this depends on the
videocard and the X server you use.  For most videocards it is better to
setup Cyrillic before the X server is started.  This package allows you
this.  To reconfigure it use the command

dpkg-reconfigure console-cyrillic

Other chipsets might require specific video driver options in order to
restore all console settings correctly. For example, if you selected any
font size other than 16 for console, it is necessary to add the
following line into "Device" section of xorg.conf when using i810 driver
with some integrated graphics controllers:

  Option "VBERestore" "true"

Please, read 'man i810' (or 'man <your driver name>') for additional
information and, more importantly, for warnings on using the options.


		      5. ADDITIONAL INFORMATION

The files *.kmap are keyboard maps.  The file cyrillic.fallback.gz is
a SFM fallback table that gives approximations of some symbols and
letters in the Cyrillic encodings with other symbols and letters.  The
file cyrillic-graph.fallback.gz gives approximations also for the
pseudographic symbols.  Most of the other data files are explained in
the files README.eng and README.ru

--
Anton Zinoviev <zinoviev@debian.org>
