1. Installing the fonts and the chess-style
-------------------------------------------
Lots of people have a laserprinter with a Canon Engine (300dpi, write
black).  For those people I have included the pkfonts and the tfm-files. 
Installation of the chess-style and chessfonts, in this case, consists of
the following steps (otherwise proceed with 2.):

			(I assume that $HOME points to your home-directory 
			 and $TEX to the place where TeX is installed, on
			 many UNIX sites this is /usr/local/lib/tex)

 a) Copy the tfmfiles in ../fonts to your destination,
	A typical destination on UNIX is $TEX/fonts if you make them 
	available for everybody, or $HOME/fonts if you prefer your
	own copy. 

 b) Copy the pkfonts in ../pkfonts to your destination
	On UNIX $TEX/pkfonts (ex.) or $HOME/pkfonts if your driver 
	supports a `packed fonts'-path.

 c) Copy the style file chess.sty from ../inputs (I have includede also
    my version of a4wide.sty and a4.sty for completeness) to your
    destination
	 On UNIX $TEX/inputs (ex.) or $HOME/inputs

 d) set the environment variables so that all stuff above can be located
	My favourite (C-shell) initialisations are:
	   setenv TEXFONTS	.:$HOME/fonts:$TEX/fonts
	   setenv TEXINPUTS	.:$HOME/inputs:$TEX/inputs
	   setenv TEXPKS	.:$HOME/pkfonts:$TEX/pkfonts:$TEX/public

       (The last environment variable is because I now use dvips5.4 in
        combination with TeX3.0!)

 e) Print the documentation available in ../doc. The documentation consists
    of the TUGboat article (TUGboat.ltx and TUGgame.ltx) and a complete game
    of Fisher against Tal (tal.ltx and tal.tex). To get a fast impression
    of the fonts you can print boards.ltx (or boards.ps if you have a
    PostScript printer).
      
    For those who are not afraid to read Dutch there is a SchaakMaatje.ltx,
    the magazine I made for our chess club.

2. Generating the fonts.
------------------------
To generate the chess fonts you need METAFONT (the actual program needed
is `mf').

To install font <font> (ex. chess20) you must:
 a) generate `<font>.tfm' and `<font>.<dpi>gf' (<dpi> is 
    a number depending on the resolution of your output device: 100 for 
    the AmigaTeX previewer, 300 for most popular laserprinters):
    
       mf "\mode:=<mode>; mag:=magstep(<magstep>); input <font>"
    
    Here <mode> should be:
      localfont  if METAFONT is installed properly and localfont has been
                 set to the parameters needed for your local printer
      amiga      if you want to generate fonts for the AmigaTeX previewer.
    
    Anyway <mode> should have a value that guarantees that you use the
    optimal settings when METAFONT generates fonts for YOUR printer or
    previewer.
      
    Here <magstep> should be a suitable value to generate the wanted
    magnification. Zero (0) generates a true sized font, 1 a font that
    is 1.2 times and -1 a font that is 1/1.2 times magnified. Normally
    you do need only true sized fonts (<magstep>=0) but with the
    AmigaTeX previewer it is handy to have magsteps -0.5, 0 and 1.

 b) Although some printer drivers accept gf-files and pxl-files, pk-files
    are preferred because they occupy less disk space. To convert from
    gf to pk format you need the program `gftopk':

       gftopk <font>.<dpi>gf

 c) Proceed with step a) and b) in 1.

3. Other remarks
----------------
If you have problems with your version of LaTeX, try if you can print and
preview doc/boards.dvi. If you have problems with your PostScript driver
try if doc/boards.ps works for you.

If you use `xdvi' as previewer, as I do on my NCD16 X-terminal at work,
you don't need extra previewer fonts. To get nice chessdiagrams with
this previewer you need to set the density (S) to 33.

I have also experimented with the previewer `xtex' but do not use it
because I have problems to get nice chessdiagrams with it.  This
previewer uses screenfonts which should be optimal for the screen you
use.  It also supports screen-servers that have Display Postscript as
the DECstations.  If somebody has positive results, let me know. 

To get optimal convenience with the previewer of your AmigaTeX, in case
you don't have a hard disk as I do, you can make an extra font disk (ex. 
Black.Myfonts), thanks to the unique font cashing scheme implemented by
Tomas Rokicki. The disk `Black.Myfonts' should contain at least:
     91 (dir)
       chess10.91pk                   chess20.91pk
       chess30.91pk                   chessfig10.91pk
     120 (dir)
       chess10.120pk                  chess20.120pk
       chess30.120pk                  chessfig10.120pk
     fonts (dir)
       chess10.tfm                    chess20.tfm
       chess30.tfm                    chessfig10.tfm

    
The chessdiag.mf METAFONT source in chess/mf draws a `mate in three
problem' on the screen if your `mf' has graphical support. To draw on
the screen you need the following command:
   mf "\mode=localfont; mag=magstep(2); screenchars; input chessdiag"
    	
If you like to make a nice T-shirt or magnified chessboard from `proof'
(or `smoke') mode pictures covering one page, try:
   mf "\mode=proof; mag=magstep(0); input chess20"
   gftodvi chess20.2602gf
   dvips chess20		(in case you have a postscript printer)

Success!

Piet Tutelaers
rcpt@urc.tue.nl
