freetype1/contrib/ttf2pk/README

   1 This directory contains ttf2tfm and ttf2pk, two utilities based on
   2
   3     afm2tfm    (dvipsk distribution),
   4     gsftopkk   (dvipsk distribution),
   5     and the FreeType rasterizer for TrueType fonts.
   6
   7
   8 Compile the FreeType library first! It is recommended to use the kpathsea
   9 library if you want to use the programs with web2c resp. teTeX. Source files
  10 for emTeX-like search routines are included; similarly, support for MiKTeX
  11 file searching routines is available if `MIKTEX' is defined during
  12 compilation. Nevertheless, as a last resort, you can compile both programs
  13 without a search library too.
  14
  15 The kpathsea library is *not* part of the ttf2pk package (see notes below).
  16
  17
  18
  19 Under UNIX-like systems say
  20
  21     ./configure --prefix=/usr/local/TeX --with-kpathsea-dir=<DIR>
  22     make
  23     make install
  24
  25 for a normal compilation and installation. Replace `/usr/local/TeX' with a
  26 path to your TeX distribution.
  27
  28
  29 [Note 1:
  30   Try to find `libkpathsea.*' on your system. Use the directory above this
  31   one as the argument for --with-kpathsea-dir. This should work in most
  32   cases. If you can't find the library, you probably have a web2c package
  33   with statically linked binaries. This means that you have to get the web2c
  34   sources from CTAN, configure it with something like
  35
  36     ./configure --prefix=/usr/local/TeX --datadir=/usr/local/TeX \
  37                 --enable-shared --disable-static
  38
  39   according to your setup; then change to the kpathsea directory and say
  40   `make' and `make install' (Do the latter with caution not to overwrite
  41   binaries like kpsewhich).
  42
  43   It even works with the source tree from the TeX Live CD 3! You just have
  44   to add a proper --srcdir option to the configure script.
  45
  46   Unfortunately, teTeX-0.4 uses a very old kpathsea library version without
  47   automatical shared-library support, thus you have to install the static
  48   libraries:
  49
  50     .) unpack the sources (basically you need only the contents of kpse-2.6
  51        and the two subdirs `kpathsea' and `make'.
  52
  53     .) say
  54
  55          ./configure --prefix=...
  56          make
  57
  58        in the kpse-2.6 directory
  59
  60     .) say
  61
  62          make install-library
  63
  64        in the kpathsea subdirectory. See Note 2 also.
  65
  66   DON'T USE A NEWER KPATHSEA VERSION IF YOU USE teTeX 0.4 BINARIES! Newer
  67   kpathsea versions are not compatible with version 2.6.
  68
  69  Note 2:
  70   It seems that c-auto.h created during the kpathsea library compiling
  71   process won't be installed for some older web2c versions. You should add
  72   it manually, i.e., copy <web2c source tree>/kpathsea/c-auto.h to the
  73   location where the other kpathsea header files have been installed.
  74
  75  Note 3:
  76   If you want to use the --srcdir option of the configure script, you must
  77   compile FreeType with --srcdir too. You have to use the same directory
  78   structure to make it work (i.e., if you have said for FreeType
  79   `./configure --srcdir=foo', and you are in the `bar' directory, FreeType's
  80   configure script will generate all the needed subdirs for compiling
  81   FreeType. You've then manually to add the directory `bar/contrib/ttf2pk';
  82   there you should start to say ./configure --srcdir=foo/contrib/ttf2pk').]
  83
  84
  85
  86 Use Makefile.dm for emx + dmake and say
  87
  88     dmake -r -f Makefile.dm
  89
  90 [Note: It should work with djgpp too, but I haven't tested this.]
  91
  92
  93 ttf2pk and ttf2tfm are already part of MiKTeX.
  94
  95
  96
  97 Primary author of afm2tfm: T. Rokicki,
  98 Primary author of gsftopk: P.Vojta
  99 Primary author of the kpathsea library,
 100                   afm2tfm/gsftopk adaptation: K. Berry.
 101
 102 --
 103 Frederic Loyer <loyer@ensta.fr>
 104 Werner Lemberg <wl@gnu.org>