The purpose of this file is to help in installation of "Gurmukhi for TeX"
software package on a Unix. In addition to this file Readme and manual.gm,
are also provided which provide information about how and why to use this
package

Lets assume that you have installed TeX and TeX can call METAFONT for
font creation. I have Tex Version 3.1415N (C version 6.1), and METAFONT
Version 2.71 (C version 6.1). I got all these tools with Linux version
1.2.1.

Lets also assume that you are installing this software under a directory
"/usr/abc/gurmukhi". Under this directory make top-level TeX directory
lib/tex. In this top-level TeX directory /usr/abc/gurmukhi/lib/tex, make
sub-directories "macros", "mf", "pk", and "tfm", and move all *.mf files
in mf directory, *.tfm files in tfm directory, *.pk files in pk directory,
and gmmacs.tex file in macros directory.

Compile the preprocessor, gurmukhi.c and put the executable somewhere on
your path. With following command, you will get preprocessor with name
"gurmukhi", 
cc -o gurmukhi gurmukhi.c

To set the environment variables in a c-shell environment, you can create
a file with following information and "source" it every time you want to
use this package.

set texbase = /usr/abc/gurmukhi/lib/tex
setenv TEXINPUTS .:$texbase/macros:
setenv TEXFONTS :$texbase/tfm
setenv TEXPKS :$texbase/pk
setenv MFINPUTS :$texbase/mf
unset texbase

Note that leading and trailing colon tells TeX to append the system path
at that point. If you have an older version of TeX (before version 3),
you may need to explicitly specify them in the environment variables. If
you use xtex, you will need to explicitly list your system directories in
the TEXFONTS variable, since it doesn't understand the leading/trailing
colon convention.


After this setup you are ready to use this package. You can use example
file bani.gm and eg.gm to see if everything is alright. A typical set of
commands can be given as follows. This information is in greater detail
in manual.ps

gurmukhi bani
tex bani
dvips bani.dvi

You can view the generated files using any one of following

xdvi bani
gs bani
ghostview bani

and can send .ps file generated by dvips to your laser printer.

There are programs equivalent to dvips for some non-laser printers
and are available at tex-archive sites.


------------------------------------------------------------------------
Amarjit Singh
E-mail Address:  asingh@evovling.com
Postal Address: 8405 E. Hampden Ave #11N Denver CO 80231 USA (Current)
                A-3 Mansarover Garden, New Delhi 110015 India(Permanent)
------------------------------------------------------------------------