*****************************************************************
* ReadMe file for Fonts directory				*
*****************************************************************

0. Index
~~~~~~~~
1. Introduction
2. Font name conventions
3. Sub-styles
4. Links
5. Thanks
Format of Zap font file
Format of Zap font link file


1. Introduction
~~~~~~~~~~~~~~~
This directory contains bitmap fonts in a format understood by Zap
(described ath the end of this file).

Some fonts just contain characters (codes &20-&FF) and some contain control
characters (&00-&1F) as well. Those without control characters have A-Z
copied to 1-26 etc when Zap loads them.

A detailed list of who supplied the fonts and the copyright for the fonts is
given in the Copyright file.


2. Font name conventions
~~~~~~~~~~~~~~~~~~~~~~~~
In general the recommended naming convention is as follows:

 <size>.<name><style><ctrl>
 
where:

 <name> is the name of the font. Usually the first 3 letters of the author
	or "X" for X windows style fonts or "C" for `clean' fonts.
	
 <style> is the font style: Eg
	""	  = Default
	"Bold"	  = Bold
	"Italic"  = Italic
	"BItalic" = Bold and Italic
	"Thin"	  = Thin
	"rk"	  = Roman + Kana font
	"ss"	  = Sans serif
	"Script"  = Script (handwriting) style

Styles may be exaggerated (in some aspect) by appending a '+' e.g. 'Bold++'.

 <ctrl> is the type of control characters used by the font: Eg
	"Dec"	= Decimal
	"Hex"	= Hex
	"Dom"	= Old Zap control characters.

There may be some excetptions to the naming convention.  Rarely used fonts
which are very small may be placed together in a single directory called
'-Small'.  There is also scope for placing vey large fonts in the directory
called 'Misc'.

Font files are typed as Data files.


3. Sub-styles
~~~~~~~~~~~~~
If the chosen font is a directory then Zap uses any files inside it named
'0' as the location from which to load the font.  Sub-styles may be included
in this directory, by placing files there with the names 'B', 'I' and 'U'.
If the appripriately named sub-style is unavailable, the base font is used
in its place.

The 'B' font is referred to by Zap in its font menus as 'Bold';
 "  'I'  "    "     "    "   "  "   "  "   "     "    " 'Italic';
 "  'U'  "    "     "    "   "  "   "  "   "     "    " 'Underlined'.

These fonts may not always actually fit into their respective descriptive
categories.  If the base font is fairly bold, it is permissable for the
'Bold' font to be very thin.  Similarly, if the base font is italicised
then the italic sub-style may be normal.  The underlined font may sometimes
be bold and italic, or sometimes, something completely different.

Though not all of the available fonts are have all their sub-styles present,
there are now a large number which do.  Font manipulation utilities are
provided for those who wish to make their own customised fonts.


4. Links
~~~~~~~~
Text files are allowed to be used as soft links.  Links are not allowed to
point at other links.  Currently, they should not be placed in the first
level of the directory structure.  If they are placed there, then when the
user selects a link, the font linked to will be the one which gets ticked in
Zap's font menus.

The exception to the above is a file called '0' which will not be indicated
in the menu structure.  This is the font which is chosen if the user chooses
the directory which contains it.  It may be a link.


5. Thanks
~~~~~~~~~
Thanks in particular to the following for designing fonts, converting fonts
from pubic domain sources, and creating font mainipulation utilities:

 Ben Avison		(see 08x16.Ben)
 Nick Craig-Wood	(see 08x16.NCW / PC)
 Martin Ebourne		(see 08x14 - also bdf->zap)
 Dave Lawrence		(see the Teletext fonts and 08x17.DavePixel)
 George Saliaris	(see 08x16.Sal)
 Darren Salt		(see 08x16.FBoldDS and sub-styles)
 Dominic Symes		(see 08x08.SysDom etc)
 Reuben Thomas		(see 06x08.Z88 and some system variants at 08x08)
 Alexander Thoukydides  (see 07x14.XAlex and sub-styles - also FontUtils)
 Tim Tyler		(see 08x16.Man and sub-styles etc)

If you'd like your fonts included then please send them in. Please make it
clear who owns the copyright on the fonts and what the conditions are for
including them.

*****************************************************************
* Format of Zap font file					*
*****************************************************************

This format has be designed to make it easy for Zap to read so it
doesn't need to contain any conversion code.

File format:

	#&00 "ZapFont",13
	#&08 Width of each font character in pixels
	#&0C Height of each font character in pixels
	#&10 First character code given (eg 0 or &20)
	#&14 Last character code given +1 (eg &100)
	#&18 Reserved (0)
	#&1C Reserved (0)
	#&20 Bitmaps (starting at character code given in #&10)
	     Format of bitmaps is as for ZapRedraw documentation.
	     Characters >=256 used for cursors - see ZapRedraw docs.

*****************************************************************
* Format of Zap font link file					*
*****************************************************************

This format was designed to be simple, self-explanatory and short.

File format:

	#&00 "ZFLK",10
	#&05 Path of the font linked to, zero-terminated.
