TeluguTeX
                      ---------
PLease read CopyrightLong file before proceeding.

TeluguTeX enables you to typeset Telugu text using TeX/LaTex
family of software. This package mainly contains two sets of 
programs. One set is used to create symbols used in composing
Telugu text. These programs are written in METAFONT. The other
set of programs use these symbols as componants to assemble
Telugu text. These programs are written in TeX (macros). Once
you have generated the fonts for the sizes and styles that you
need you do not have to worry about the METAFONT programs( unless
the output device changes). But you will always need the TeX
programs to typeset Telugu text.

Following is a list of files in this package:

 CopyrightLong   - copyright notice. MUST BE READ
 CopyrightSources- copyright notice that appears in source files
 telugu.mf       - defines font dimensions
 telparam.mf     - defines parameters
 telbase.mf      - contains macros for commonly occuring shapes
 telmode.mf      - contains mode for the output device
 telcodes.mf     - defines codes for all the symbols in the font
 telchars1.mf    - contains program to generate vowels, consanant bases,
                   vowel modifiers, consonant conjuncts and accents
 telchars2.mf    - contains proggrams to generate consonant+vowel
                   combinations that need new symbols
 telchars3.mf    - contains programs to generate roman digits, telugu
                   digits and punctuation symbols
 telfonts.awk    - contains size/style specific parameters
 makefile        - use this to generate the font(s)
 README          - you are reading this file
 VERSION         - This is the place to look if you want to know
                   the version identification/history of changes
 document.tex    - documentation( extracted from Lakshmi Mukkavilli's
                   M.S report and modified)
 tlxlate.tex     - implements transliteration
 tlsyllable.tex  - composes a syllable
 tlteldigits.tex - defines telugu digits
 

Next let us worry about installing TeluguTeX:

Font contains 233 symbols. You need large METAFONT to generate
these symbols.
To typeset Telugu you need Big TeX. Typesetting Telugu is a very
CPU intensive job. 

It is assumed that you are installing TeluguTeX under UNIX(tm).
If you are installing TeluguTeX under UNIX(tm)
then you can skip rest of this paragraph.
METAFONT and TeX programs in this package are not dependent on UNIX,
but make and awk programs are needed.
If you do not have these programs then you will have to
do some work. You will have to extract various parameter files from
telfonts.awk and execute METAFONT on each parameter file. You will 
be essentially executing steps in makefile manually.
Each parameter file in telfonts.awk begins with the pattern '%fontfilename%'
and ends with a line containing just two % symbols('%%').
Some non-UNIX(tm) system limit the length of file names. On these
systems you may have to rename some of the files.

Steps in installation:

  1. define mode for the output device in telmode.mf
  2. copy tlsyllable.tex, tlxlate.tex and tlteldigits.tex to a  
     directory from where TeX can read \input files.
  3. copy following files to the directory that will contain
     the font files that you will generate.
        all .mf files
        telfonts.awk
        makefile (make sure that the destination directory does not
                  contain  'makefile'.)
  4. goto the directory to which all .mf files have been copied.
  5. edit makefile
      a. change DPI to reflect the characteristics of of the
         output device.
      b. If you do not want to generate ALL fonts then define
         MYFONTS object listing the size/style combinations
         that you want. If you do not include all 12 size
         fonts then you can not print the documentation. 
         Please read comments at the top of 'makefile'.
         Towards the end of this file we have included a list
         giving approximate sizes of various font(pk) files.
         You may want to look at that to get an idea about the
         storage requirement.
  6. If you have not decided to generate ALL fonts then
     edit tlsyllable.tex to comment out those font definitions
     that invoke the font(s) that you have chosen to omit.
     You can do this by inserting a '%' sign in column one.
  7. Enter 'make all' or 'make myfonts' depending on what you
     decided in step 5.b .
     'make all' on SUN SPARCstation IPC takes about an hour.
  8. as a result of 'make ..' tloffsets.tex must have been 
     created. copy this file to the same directory as tlsyllable.tex.
  9. print TeluguTex.tex  (enter latex TeluguTeX)
     look at the examples.                  

  A note from the authors:

    we hope you will find this package useful for typesetting
    Telugu. TeluguTeX was developed by us when we were at
    Iowa State University, Ames, Iowa, USA.
    Please direct your criticism/comments about TeluguTeX to
    email:      lzk60@css.amdahl.com
    snailmail:  915 Almaden Avenue
                Sunnyvale, CA  94086  USA
    Amount of time we can spend on TeluguTeX is fairly limited,
    so please do not expect a prompt response.
    If you have questions about METAFONT, TeX, LaTeX, drivers etc.
    you should turn elsewhere. We assume that you know how to
    generate fonts using METAFONT, how to use TeX/LaTeX and
    how to produce output on whatever device you may have. 

              Happy TeluguTeXing,

                             Lakshmankumar Mukkavilli
                             Lakshmi Mukkavilli


 file            size(bytes)             file            size(bytes)
-----------      ---                    -----------      ----
CopyrightLong	 8072			tel20b.300pk	 20860
CopyrightSources 896			tel20b.tfm	 1544
document.tex	 69654			tel20s.300pk	 21484
makefile	 3750			tel20s.tfm	 1544
tel10.300pk	 10748			tel25.300pk	 27004
tel10.tfm	 1532			tel25.tfm	 1548
tel100.300pk	 140600			tel25b.300pk	 26644
tel100.tfm	 1556			tel25b.tfm	 1548
tel10b.300pk	 9788			tel25s.300pk	 27976
tel10b.tfm	 1532			tel25s.tfm	 1548
tel10nx.300pk	 10264			tel30.300pk	 33296
tel10nx.tfm	 1532			tel30.tfm	 1552
tel10ny.300pk	 9888			tel30s.300pk	 35912
tel10ny.tfm	 1532			tel30s.tfm	 1552
tel10s.300pk	 10484			tel35.300pk	 39608
tel10s.tfm	 1532			tel35.tfm	 1556
tel11.300pk	 10752			tel35s.300pk	 44600
tel11.tfm	 1532			tel35s.tfm	 1556
tel11b.300pk	 11208			tel40.300pk	 50356
tel11b.tfm	 1532			tel40.tfm	 1552
tel11nx.300pk	 11652			tel40s.300pk	 53600
tel11nx.tfm	 1532			tel40s.tfm	 1552
tel11ny.300pk	 10836			tel55.300pk	 75328
tel11ny.tfm	 1532			tel55.tfm	 1556
tel11s.300pk	 11612			tel55s.300pk	 79980
tel11s.tfm	 1532			tel55s.tfm	 1556
tel12.300pk	 11840			tel72.300pk	 101172
tel12.tfm	 1536			tel72.tfm	 1556
tel12b.300pk	 12184			telspa.300pk	 34472
tel12b.tfm	 1536			telspa.tfm	 1556
tel12nx.300pk	 12300			telspb.300pk	 129220
tel12nx.tfm	 1536			telspb.tfm	 1556
tel12ny.300pk	 11504			telspc.300pk	 114644
tel12ny.tfm	 1536			telspc.tfm	 1556
tel12s.300pk	 13484
tel12s.tfm	 1536			CopyrightLong	 8072
tel15.300pk	 15884			CopyrightSources 896
tel15.tfm	 1548			document.tex	 69654
tel15b.300pk	 15468			makefile	 3750
tel15b.tfm	 1548			telbase.mf	 29160
tel15s.300pk	 15648			telchars1.mf	 30370
tel15s.tfm	 1548			telchars2.mf	 15885
tel172.300pk	 264156			telchars3.mf	 17198
tel172.tfm	 1556			telcodes.mf	 10004
tel18.300pk	 19168			telfonts.awk	 9982
tel18.tfm	 1540			telmode.mf	 992
tel18b.300pk	 18868			telparam.mf	 7202
tel18b.tfm	 1540			telugu.mf	 1912
tel18s.300pk	 19116			tloffsets.tex	 9650
tel18s.tfm	 1540			tlsyllable.tex	 34188
tel20.300pk	 21028			tlteldigits.tex  1781
tel20.tfm	 1544			tlxlate.tex	 8251

(These sizes are not accurate. Files may have changed since these
 sizes were recorded.)