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) ------------------------------------------------------------------------