Those who have used the previous version of greektex, may wish to go
directly to the end of this file in the section CHANGES, which describes
the new features of this extended system.


                           greektex

     The programs in this package make it possible to process in Plain
TeX and LaTeX (with complete functionality) files which contain mixed
Greek and English text. The system accomodates both the modern
(monotoniko) Greek, as well as the classical (polytoniko) spelling
system, with aspiration marks, accents and the iota subscript. It uses
common extensions of the Knuth fonts and the well known Greek fonts
designed by Silvio Levy. To install and use these programs you need to
have a complete TeX (version 3.0 or later) with its initex program
installed in your machine.  You also need the standard files needed to
build plain TeX and LaTeX, including hyphen.tex and latex.tex. To print
the dvi files produced by the system you need a 300 DPI laserprinter and
a dvi driver capable of handling 8 bit fonts. 

     This file explains how to install the system on an IBM compatible
PC with a hard disk and a VGA screen running DOS, and I have included
the necessary programs and instructions for creating in such a machine
textfiles with mixed Greek and English text. It will be clear which
steps should be omitted or modified if you are installing to a different
machine, but then you must find your own solution to the problem of
entering Greek text. (The filters in filters.zip offer a solution, not
very good.) Instructions for using the system and a general description
of how the system works can be found in the file greektex.doc.

A complete listing of the files in this package is given in the INDEX
file which is reproduced here:

(1) README          General information and instructions for installing
                    the system. (This file.)

(2) greektex.doc    The document describing how to use the system. 
                    It also gives the credits for the public domain 
                    programs used and distriibuted.

(3) pkunzip.exe     The program needed to uncompress zip files.

(4) extkb.com       Extended keyboard program for the PC.

(5) vga_ligh.com    Greek character set loaders for the PC with 
    vga_bold.com    a VGA screen.

(6) geinputs.zip    The TeX input files needed by the system.

(7) getfm.zip       The tfm files for the English-Greek fonts.

(8) gepk.zip        The pk files for the English-Greek fonts.

(9) gemf.zip        The metafont files used to create the font, 
                    with a brief instruction document gemf.doc and 
                    and some batch files for compiling fonts in 
                    additional pointsizes and resolutions.

(10) filters.zip    Two simple Greek-to-English and English-to-Greek 
                    filters (written in C) which make it (just barely) 
                    possible to create, read and convert files with 
                    mixed Greek and English text in a monolingual 
                    environment. See l2g.c for explanation.

(11) grsample.ps    Postcript file of a 15 page excerpt from
                    a Set Theory book which illustrates 
                    mathematical, monotoniko output (and 
                    plugs the book).
                     
(12) polyton.gr     Greek input file and Postcript file of a one
     polyton.ps     page document which illustrates the method for 
                    entering polytoniko and the output produced.

IMPORTANT. If you are getting these files by ftp, make sure that  (3) -
(10) are transmitted in binary mode. Files (3) - (5) and (9) - (12) are
not needed for installing and running greektex.

====================================================================

                      Installation procedure


You may already have pkunzip and programs equivalent to (3) and (4). 
If you do not, follow Step 1, otherwise go directly to Step 2.

1. ===========================

Copy the programs (2), (3), (4) in some directory on the DOS path.

2. ===========================

Copy greektex.doc in some directory where you keep documents. You may want
to take a look at it now, before installing greektex. Among other things,
it describes how to use (4) and (5) if you need them.

3. ============================

Go to the directory where your TeX looks for inputs, which contains
plain.tex, lplain.tex, latex.tex and the various sty files for LaTeX.
Copy the file geinputs.zip to this directory and type:

     pkunzip geinputs

4. ============================

Go to the directory where your TeX looks for tfm files, e.g. cmr10.tfm
should be there. Copy the file getfm.zip to this directory and type:

     pkunzip getfm

5. ============================

Go to the directory where your dvi driver looks for 300 DPI pk files. In
the PC this directory should have in it cmr10.pk, cmbx10.pk, etc. Copy
the file gepk.zip to this directory and type:

     pkunzip gepk

6. ============================

CAUTION: For this most basic installation step, I am assuming that your
main TeX program is called tex.exe and the corresponding IniTeX program
is called initex.exe. You may be using sbtex, in which case the programs
are likely to be called sbtex and sbinitex and you should adjust
accordingly. If you are using emtex, make sure that you use the proper
invocation which calls initex for 8 bit input and output to the screen,
see below.

Go to the directory where your TeX looks for format files, plain.fmt,
lplain.fmt should be there. (The file of TeX strings tex.poo is also
there.) Type

     initex geplain \dump    
     initex gelplain \dump     

In the most recent (still beta-testing but excellent) version of emtex I
have been using, the correct invocation is:

     tex386 /i /8 /o gelplain \dump

This will produce the files geplain.fmt and gelplain.fmt. After this
procedure, to latex the file george.tex (which may have Greek text in
it) you type 

     tex &gelplain george      

To process george.tex in the Greek extension of plain tex, you type

     tex &geplain george       

6. ===================   CHANGES, January 1993

(a) Monotoniko. 

    (i) The Greek quotation marks have been added to the fonts
and can be entered as <<...>>.
   (ii) Accented capitals can be entered easier by 'A, 'O, etc. 
  (iii) The diacritical marks can be entered by preceding with ",
        e.g. "i (i=iota), "y (y=ypsilon), and similarly with
        the accented iota and ypsilon.
   (iv) The Greek italic font has been greatly improved, primarily by
kerning. I have also added some kerning for the capitals in Levy's
fonts. 

Except for the ligatures << >> which print differently in English TeX,
the monotoniko "mode" of the system continues to be a "conservative
extension" of English TeX, i.e. the parts which have no Greek symbols
will print exactly as in monolingual, English TeX.

(b) Polytoniko, classical Greek.

The system can be used now (in text mode) to typeset classical
(polytoniko) Greek in a reasonably friendly way, as explained in
greektex.doc. Most of the combinations of letters, aspiration signs,
accents and iota subscripts are incorporated in the fonts as ligatures.
However, they cannot all fit in the 128 available ASCII codes 128-255,
so some are typeset with the \accent TeX primitive, which interferes
with hyphenation. Nevertheless,  the hyphenation is almost complete:

*****   the system will apply the hyphenation algorithm to  *****
*       all words which do not have                             *
*                                                               *
*               (1) an aspirated peripvmenh                     *
*                            or                                 *
*****  (2) an accented letter with an iota subscript.       *****

The words in category (1) are at most two-syllable long, and they 
almost never need to be hyphenated. In practice, there are very few
words in category (2)---and in fact the system hyphenates some of these 
words, when the accent on the iota-subscripted letter is oxeia. I have
not been able to test the hyphenation on extensive, classical Greek
manuscripts (I don't have any on line), but on the basis of my limited
testing I believe that the system will hyphenate classical Greek at
least as well as TeX hyphenates English---and the rest can be done by
hand, of course.

You must invoke the monotoniko mode before entering math mode. 
The polytoniko system has active characters, so it is not guaranteed to
work well with all packages, but as far as I can tell it causes no
difficulties with the standard constructs of plain TeX and LaTeX.

(c) Metafont. This distribution includes all the metafont files needed
to produce the Greeklish fonts and a brief instruction sheet on how to
use them. These files are compressed in gemf.zip. They can be used (with
a running version of metafont) to produce fonts in any point size and at
any resolution.

---------------------------------------------------

As far as I know, all the programs in this package are in the public
domain and they are offered without any obligation or guarantee, with
the usual proviso that if you change any files you should also change
their names. I will appreciate comments and corrections.

Yiannis N. Moschovakis
Department of Mathematics
UCLA, L.A. CA 90024
ynm@math.ucla.edu

January 1993
