INSTALL file for the -misc-fixed-iso10646-1 outline font

This file describes how to install the font for use under various OS and
programmes.

1. Building the font (if you downloaded the complete sources)

Skip this step if you downloaded a precompiled version of the font.

You will need a working Ghostscript (http://www.ghostscript.com/) to build 
the font.

  I. Unpack the distribution:
      gunzip misc-fixed-x.y.tar.gz
      tar -xvf misc-fixed-x.y.tar
 II. Do the compilation:
      cd misc-fixed-x.y
      make

2. Installing the font

Unix and relatives
==================
(this section might be splitted on the different OSes if there are significant
differences between them).

The font/printing system under Unix is not one single entity as it is in the 
OSes for personal/desktop computers, instead each part is essentially 
independent and does not know about the resources available to other parts.

The following parts may be candidates for installation: the X-server, the
printmanager or printer, and individual programmes that embed fonts into their
output.

The X-server already has the bitmapped misc-fixed fonts so it probably does 
not need the outline font.

I would not recommend installaing the font in a printmanager or printer, 
since it will be in an experimental/development stage for quite some time.

Individual programmes can be candidates for installing and testing the font. 
Since they generate self contained output files (they can embed fonts into 
files) there should not be any additional work to display or print the 
document (it should even become portable!). In the following subsections 
installation procedures for some specific programmes will be given, please 
check with the documentation that came with the programme if your version is 
not the same as described here.

GNU enscript
------------
Version 1.6.2

GNU enscript is used as the reference test programme in this project.
The installation of fonts is done either for a specific user or system wide.
For more complete instructions see GNU enscript's README file.

A. User installation

 1. Copy the .pfa and .afm file to some subdirectory of your home directory.
 2. Run    mkafmmap *.afm   in that directory.
 3. Add the full path of the directory to the AFMPath in your ~/.enscriptrc .

B. System wide installation

 1. Copy the .pfa and .afm file to some directory readable by all users.
    Enscript searces the directories /usr/local/lib/ps and /usr/lib/ps for
    fonts, but you can put the fonts anywhere you like.
 2. Run    mkafmmap *.afm   in that directory.
 3. Add the full path of the directory (if it is note already included) to 
    the AFMPath in the global enscript configuration file 
    $(prefix)/etc/enscript.cfg, where $(prefix) is the installation prefix 
    used (/usr/local if you didn't change it when you built the programme).

Now the font is available under the PostScript name Misc-Fixed (the name might
change in the future), so to print a file containing russian encoded in koi8-r
'test.txt' with enscript and this font you can run

  enscript -fMisc-Fixed10 -X koi8 test.txt

Unfortunately, enscript does not support Unicode yet so you will only be able
to access a subset of the font at a time, corresponding to one eight-bit 
coded character set.

yudit
-----
Version 1.5
Yudit only accepts TrueType fonts and since TrueType has not been added yet 
it is no use trying to install it.

One interesting note though: in the process of printing yudit extracts the 
outline data from the TrueType font and builds a custom PostScript Type 3 font,
which it embeds into the document and uses. In principle it would be possible 
to extend yudit to use the Type 1 font (the process of embedding and recoding 
the font is the same, but the programme must be able to recognise the 
PostScript font file and treat it correctly). Of course, TrueType has native 
support for Unicode, Type 1 has not.


More information
----------------

More information about fonts and font installation for GNU/Linux can be found
in the Font HOWTO, available from the Linux Documentation Project.


DOS/Windows
===========

Not tested. It seems that for the PostScript version the files must
be in .pfb and .pfm format. See TODO.


Macintosh
=========

Not tested. The Macintosh likes binary formats based on the resource
manager for most things, in this case probably a suitcase.

If there is a need I might consider adding output-formats for the Macintosh.
Drop me an email.






==============================================================================

Contact address see README.
