This file is part of the vncmr package ver 2.2 (15-Jul-1996)


vncmr is a Vietnamese extension of the Computer Modern Roman font family. It
provides all precomposed Vietnamese glyphs with mapping tables to VISCII 2.0
order (i.e. VISCII 1.1 with the characters `Y?' and `Y.' additionally
doubled at the positions 0x17 and 0x18 respectively) for all cmr fonts which
make sense for Vietnamese (no mathfonts, no cmtex fonts etc).

The following Vietnamese characters simply overwrite the original cm glyphs
(Greek uppercase letters) at these code points:

        0x00  A(? (VISCII 2)    0x3   Y? (VISCII 20 and 23)
        0x01  A(~ (VISCII 5)    0x4   Y~ (VISCII 25)
        0x02  A^~ (VISCII 6)    0x5   Y. (VISCII 30 and 24)

if you need the original cm characters, use a cm font directly or its
symbolic names. All other characters are in the range 0x80-0xFF.

Consider this package as an intermediate step towards a vndcr package (i.e.
a Vietnamese font family based on the dc fonts)---it has the same problems
as the cmr family, namely inconsistencies in the character repertory of
different fonts.


Installation
============

1)  Unpack the archive. It contains a texmf tree conformable to the TDS
    standard. If your system already supports TDS (e.g. teTeX), the
    structure of this tree need not to be altered and can simply be copied
    into your system's texmf-tree. Proceed with step 5. If not, continue.

2)  Move the .mf-files to a directory which Metafont scans.

3)  Move the .tfm-files to a directory which will be found by TeX.

4)  Move all files in the plain and latex subdirectories of texinput to an
    appropriate place TeX scans for input files. Here you find material for
    LaTeX2e and plain TeX:

        ET5xxx.fd       LaTeX2e font definition files for the vmr family.
        ET5enc.def      Vietnamese ET5 encoding definition file for LaTeX2e.
        viscii.def      VISCII 2.0 input encoding file for LaTeX2e.
        vscii.def       VSCII-1 (also called TCVN-1) input encoding file
                        for LaTeX2e.
        vietnam.sty     language specific headers. Will always load
                        ET5enc.def .

        viscii.tex      VISCII input encoding file for plain TeX.
        vnfont.tex      simple font definition file for plain TeX.
                        [Note: the macros in these files are only defined
                         globally. If you want Vietnamese locally, simply
                         \input the files inside of a group. The commands to
                         get Vietnamese encoding and fonts again are then
                         \VISCIIencoding and \vnfonts respectively.]

5)  For teTeX (and perhaps other systems) you should add the following line
    into texmf/fontname/special.map:

        vm  lemberg vm


Usage
=====

plain TeX:

    ...

    \input viscii\relax
    \input vnfont\relax

    ... your Vietnamese text in VISCII encoding ...


LaTeX2e:

    ...

    \usepackage[ET5]{fontenc}
    \usepackage[viscii]{inputenc}

    ...

    \begin{document}

    ... your Vietnamese text in VISCII encoding ...



Please send any comments or suggestions to

    Werner Lemberg <a7621gac@awiuni11.bitnet>
                or <a7621gac@helios.edvz.univie.ac.at>


=== end of README ===
