
This is version 1.0 of the CallMF package, the ARexx scripts for automatic
font generation with 'PasTeX'.

    Enjoy,
      Georg, J\"org, Martin, Ulrich.

-----

Sorry, the english doc is only a readme.  But if anybody likes to translate
the german doc feel free.

Ulrich

GERMAN users, please read doc/MFRexx.tex!

-----

This  file  describes  installation and usage of the programs for automatic
generation of fonts with Metafont (MF).

Installation:
=============

1)  copy  the  file  'modes'  to MF:config/ and change it to fit your local
modes.mf  or use the PasTeX-modes.mf which comes with these macros.  If you
want  this then copy #?.mf to MF:inputs/ and don't forget to generate a new
plain.base file!

2)  copy  the  files  'MakeBatch.rexx'  and 'MakeTeXFont.rexx' to the REXX:
directory.  preferably use MF:REXX directory.

3)  set  the  environment variable 'CallMF' to 'MakeBatch' or 'MakeTeXFont'
(you  will  know  which when you have finished reading this text).  Or even
better,  include  the  full  path  to  these  macros  in the variable, like
"MF:Rexx/MakeBatch.rexx".


MakeTeXFont:
===========

MakeTeXFont produces the fonts.  Call it with the following parameters:

 font         name of the font (e.g., cmr10)
 dpi          resolution of the font (e.g., 360)
 hbasedpi     the horizontal ...
 vbasedpi     and vertical resolution of the output-device
 drivertype   the name of the caller (show, print, ...)
 pkfilename   name of the file the font should be saved to
 pkdir        directory, where the pk-file should be saved
              fhe last character of the path must be a '/' or ':'!


With the command

   > rx MakeTeXFont cminch 120 100 100 show 120/cminch.120pk ram:pk/

you  can  produce the font cminch for the previewer (100 dpi resolution) at
magstep   1   by   hand.    The   generated   font   will  be  saved  under
'ram:pk/120/cminch.120pk'.  The directory RAM:pk must exist!  The directory
ram:pk/120 will be created for you.

Normally you don't need to know these details since MakeTeXFonts usually is
called by 'ShowDVI', 'PrintDVI' or an automagically generated batchfile.


MakeTeXFont does the following operations:
- transforming the parameters for MF
- calling MF
- converting  the  font  into  a PK-file  and  moving it to the appropriate
  directory
- renaming the MF-logfile

MakeTeXFont produces it's own logfile with an entry for each font generated
in the file mf:log/MakeTeXFont.log.

Problem:
You  may  easily run out of memory if there are some other programs running
(especially DVIPrint needs a lot of memory).  If you have this problem when
MakeTeXFont  is  called  from  another  program  use  MakeBatch instead and
execute the batchfile later when there is enough free memory.



MakeBatch:
=========

MakeBatch  has  to  be called with the same parameters as MakeTeXFont.  But
MakeBatch  does  not immedeatly generate the font, it only writes a call to
MakeTeXFont in a batchfile which may look like the following:

  rx MakeTeXFont SLURDD16 91 91 91 show 91/SLURDD16.91pk TeX:pk/
  rx MakeTeXFont SLURDU16 100 100 100 show 100/SLURDU16.100pk TeX:pk/
  rx MakeTeXFont SLURUU16 120 100 100 show 120/SLURUU16.120pk TeX:pk/

Later,  when  you  want  to  generate the fonts simply 'execute' this file.
This method is usefull if many fonts should be generated and you don't want
to  wait  or  if  there  is  not  enough memory to generate fonts while the
DVI-driver is running.  The batchfile gets the name 'mf:MakeTexFont.sh'.

MakeBatch  takes  care  if  the  font  to  be  generated  already is in the
batchfile,  so  a  font  is  NOT  generated  twice  if  you preview several
DVI-files where the same font is missed several times.



MakeTeXFontSet:
==============

Produces  a  full set of fonts for a given driver.  Just start it.  It will
ask  you  for  everything.   Make sure you have an empty harddrive, a 68040
Amiga and a lot of time.  For Printers METAFONT will be called 13 times for
ShowDVI  22 times.  Guess how long will all cm fonts need?  IF one METAFONT
call  will take 10 minutes cmr10 will need 220 minutes only for ShowDVI and
another  70  minutes  for  your  printer all in all 300 minutes or 5 hours.
ONLY cmr10, think of all the other cm-fonts.

            CAUTION! BY USING THIS MACRO!!!

General:
=======

All  programs  are  in  the  public  domain.   You may copy and modify them
freely.

I've  done all my fontmaking with the help of these programs, but there are
certainly some 'undocumented features'!

Send bugreports, your own improvements and new ideas to:

Martin Bokaemper
Reuthstr. 12
91099 Poxdorf
Germany

email: mnbokaem@cip.e-technik.uni-erlangen.de
       mab@ame.ZER  (Zerberus)

PS.: Since these files may go through several different machines via
     email I took the 'international version' of my name. If you use
     TeX or something else that can handle 'umlauts' write to
     Martin Bok\"amper instead of Bokaemper. :-)

or try:
  hessmann@unipas.fmi.uni-passau.de
or:
  hoehle@cs.uni-sb.de
or
  Ulrich Wisser      ! Always use this address for MakeTeXFontSet.rexx
  Heerstr.  125
  53111 Bonn
  G E R M A N Y
