Passau (FRG), August 23, 1990

First, the copyright notice:

      Showdvi and dviprint are distributed in binary form.
      Flib,  imginfo  and  environ  are  distributed in both binary and
      source  form.  The  programs and code are copyrighted, but may be
      freely distributed.
      The only restrictions are:

       1.  No  charge  may  be  made  other than reasonable charges for
           reproduction.  In  case  of doubt contact one of the persons
           whose addresses are listed at the very end of this file.

       2.  Modified versions must be clearly marked as such.

       3.  The   authors   are   not   responsible   for   any  harmful
           consequences  of  using  this  software, even if they result
           from defects in it.

      You  are  encouraged  to  make  copies  for friends, upload it to
      bulletin  boards,  or  distribute it via networks.  This is not a
      shareware  product.


Second, a warning:

 THIS IS ONLY A QUICK-REFERENCE FOR USING THE PROGRAMS
                -----

           showdvi - show TeX dvifiles on monochrome and color screens

	   dviprint - print TeX dvifiles on various printers

	   flib    - manages libraries of Metafont pkfiles (* Only *)

           imginfo - print some information about IMG files

           environ - set AES environment variables before AES is initialized

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

Using showdvi:

[...]

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

Using dviprint:

[...]


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

Including IMG files into TeX:
(* Work even with DVI, exept the hsize and vsize feature! *)

showdvi/dviprint can handle IMG file within TeX-DVI-files:
 Syntax:
  in TeX file:                  vvvvv horiz. vvvvv vertical size of image in cm
      \special{imgfile=ente.img hsize=10     vsize=15}
               ^^^^^^^keyword for img filename
   filenames can be of the form: e;/local/raster/ente.img
                                  ^             ^path separator (stands for '\')
                             this is ok (stands for ':')

The IMG files should be in resolution for the printer. On the screen they
are displayed in the size given as parameters at hsize and vsize within the
\special command (in cm)

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

These versions of showdvi and dviprint allow both the use of flib's and the use
of "bare" pk files. Since the loading of fonts within a flib is much faster
the authors recommend the use of flib's for the majority of the fonts.

The path to the fonts can either be specified in the font configuration file
showdvi.fnt/dviprint.fnt (see below) or via the the environment variables
PKDIR (for pk fonts) and FLIBDIR (for font libraries). It is allowed to
add more than one path to these variables. The single pathes should be
separated by ';' (or '!').
An other possibility to specify the font directory is to use the option -a.

Showdvi/dviprint look for a configuration file where to search the fonts.
This file is called showdvi.fnt/dviprint.fnt.
It is searched in:
 - the contents of the environment variable DVICONFIG (default: c:\config)
 - via the system function shel_find (this function uses the environment
   variable PATH). PATH must be set before AES is initialized (i.e. in the
   \auto directory).

The format of such a file:

; this is a comment
font_str pk%04d\%s  ; this specifies how showdvi searches single fonts.
                    ; This string is added to the below specified
                    ; directory for single fonts (e.g. f:\fonts\tex)
                    ; It is analogous to the C function printf
                    ; %d <---> resolution (e.g. 100 dpi)
                    ; %s <---> name of the font (e.g. cmr10)
font cmr10 100 f:\fonts\tex ; search the font cmr10 in the directory
                            ; f:\fonts\tex\pk0100
                            ;              ^^^^^^
flib_str pk%04d   ; analogous to font_str (only %d allowed)
flib 100 f:\fonts\tex\screen ; search the library for resolution 100 dpi
                             ; in the directory f:\fonts\tex\screen.
                             ; It must be called pk0100.

The default path for libraries:    f:\fonts\tex\libs
The path for single fonts:         f:\fonts\tex\fonts
The default mask for single fonts: %d\%s
The mask for libraries:            pk%04d

------------------------------------------------------------------
Using flib:

 commandline options:

FontLib Manager - Version 1.03 for ATARI  1990 Georg Hessmann/Robert Stabl
usage: flib c|a|x|d|z|p|l|t[v] library [-|[modules]*]
	c,a : create library / add (replace) module(s) to (in) library,
	x   : extract module(s) from library,
	d   : delete module(s) in library,
	t   : print table,
	r   : rename module(s) in library,
	z   : create new flib from old flib,
	p   : test checksums of all modules,
	l   : create a flib link (second arg is the link destination),
	v   : verbose mode,
	?   : print this help,
	-   : read module name(s) from stdin.


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

This description to the new versions of showdvi and dviprint is very, very
short. A more detailed version will be available soon (Georg is still working
on it :-).

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

If there are still any questions about the usage of the programs or if you
detect errors in the programs, feel free to contact me at:

 Robert Stabl
 Hollaenderstr. 45
 D-8390 Passau
 Germany

email:
 Internet:
      stabl@fmi.uni-passau.de
                 or
   stabl@unipas.fmi.uni-passau.de

 or UUCP:
   ...uunet!unido!unipas!stabl
               or
       stabl@unipas.uucp

