Installation instruction for cyrillic fonts in ALT encoding
      -----------------------------------------------------------

This file describes how to install cyrillic fonts on a TeX/LaTeX system.
Special attention is given to installation for EmTeX
(MSDOS-OS/2 implementation of TeX).

The CMCYRALT font distribution presented here was uploaded
to CTAN by Vadim V. Zhytnikov (vvzhy@phy.ncu.edu.tw)
on behalf of Alexander Harin (harin@lourie.und.ac.za).

I added this INSTALL file to make instllation easier for users
that don't have a lot of TeX/LaTeX experience.
For users of EmTeX I supply cyrillic font library cmcyr_lj.fli,
so they do not have to learn how to use MetaFont/MfJob.


What is required
================

1. TeX ver 3.0 or later, version 3.1415 is preferable.

MSDOS-OS/2 users:
You can get EmTeX 3.0 from CTAN directory /systems/msdos/emtex
(CTAN is Common TeX Archive Network, its site in the US
is ftp.shsu.edu:/tex-archive).
You also can get beta release of EmTeX 3.1415
from /systems/msdos/emtex/betatest.

UNIX users:
You probably already have newest version of TeX on your system.
Otherwise take a look at /systems/unix of CTAN.


2. Cyrillic style files for LaTeX2e or LaTeX 2.09.
You can get LaTeX2e files from /macros/latex/contrib/other/cmcyralt
or from ftp.cs.umd.edu:/pub/cyrillic/cmcyralt/cmcyr2e.zip.
LaTeX 2.09 (this version of LaTeX is now considered obsolete)
files can be obtained from /macros/latex209/contrib.


How to unpack and install
=========================

1. Create directory cmcyrfnt and unpack the zip file into it
with preserving directory structure.

For example, in MSDOS:

pkunzip -d cmcyrfnt.zip

1a. MSDOS users only: In this distribution end-of-line
character for text files is LF.
To convert text files to MSDOS convention (end-of-line is
CR-LF), type "convers.exe +r *.*" in directory cmcyrfnt
and all its text subdirectories (that is, all subdirectories
except VF and TFM). Convers.exe can be found in 
ftp.cs.umd.edu:/pub/cyrillic/converters.


2. Add TFM subdirectory to TFM (font metrics) path variable.

For example, in MSDOS:

set tfm=d:\emtex\tfm;d:\cmcyrfnt\tfm

Now if LaTeX cmcyr package is installed, you can use LaTeX
to produce *.dvi files. However, to print or view *.dvi files,
you have to do more.


3. Add VF subdirectory to virtual font path.

For example, if you are using dviscr to view *.dvi files
and dvihplj to print them, you have to change the /pv line
in file lj.cnf to:

/pv=d:\cmcyrfnt\vf


4. Getting cyrillic font bodies.

a) EmTeX users who need 300 DPI fonts for HP LaserJet and screen viewer:
Download file 
ftp://ftp.cs.umd.edu/pub/cyrillic/cmcyralt/fonts/cmcyr_lj.fli 
to the same directory cmcyrfnt.

Add the cmcyrfnt directory to the font library path.
Change the /pl line in lj.cnf to something like:

/pl=%DVIDRVFONTS%;d:\cmcyrfnt;lj_0;lj_h;lj_1;lj_2;lj_3;lj_4;lj_5a;lj_5b;cmcyr_lj

Examples of autoexec.bat and emtex\lj.cnf files are given
in directory cmcyrfnt\setup.


b) All others.

You will need to generate font bodies (*.pk) from
the font sources (*.mf) using  MetaFont and MfWare programs
(they are part of any decent TeX package (for example, of EmTeX)).

File cmcyr.mfj is a batch file for MfJob that performs
generation of cmcyralt fonts in PK format.
Since there is a bug in definition of cyrillic letter d
in fonts czssq8 and czssqi8, I included file mfjob.log
that lists these bugs.

After generating fonts you can create a font library (*.fli)
from them using the file setup/cmcyr.bat (EmTeX only).