                      Installation instructions

In order to build the font server, you will need:

* (part of) the sources to X; I have only tried it with plain X11R6.3
  from the X consortium;
* a working FreeType library;
* some courage.

In the following, I assume that XTOP points to the top of the X source
tree.

1. Make sure that you know how to compile the standard X font server.
   The proper way of doing this is:

  % cd $XTOP
  % make world

As this takes more or less forever, the following way, although crude
and politically incorrect, seems to work for me.

  % cd $XTOP/lib/font
  % xmkmf
  % make Makefiles
  % make
  % cd $XTOP/programs/xfs
  % xmkmf
  % make Makefiles
  % make

   Of course, you might not want to work directly in the X source
   tree, so you will need to make a link forest.  Good luck.

2. Untar the file `libfont.tar' in $XTOP/xc/lib/font.  This should
   create a subdirectory FreeFont and a file `libfont.patch'.

3. Apply `libfont.patch' in $XTOP/xc/lib/font.  Remake the makefiles
   in that directory.

4. Edit $XTOP/xc/lib/font/FreeType/Imakefile to point at the location
   of the FreeType includes.

5. Recompile $XTOP/xc/lib/font; this will generate a new `libfont.a'
   with support for TrueType.

6. Relink the Font Server with the new libfont.a and the FreeType
   library (both the static and dynamic versions seem to work).

7. You've now got a working (more or less) version of xfs that handles
   TrueType.  Please read the file `USAGE' before you send me any bug
   reports.

It is also possible to link the X server itself with the modified
libfont.a.  This is left as an exercise for the interested reader.
