NAME

       ttf2ufm_x2gs - font installer for Ghostscript

SYNOPSIS

       ttf2ufm_x2gs [config-file]

DESCRIPTION

       The fonts generated with ttf2ufm work fine with Ghostscript by themselves. The script
       `x2gs' (or `ttf2ufm_x2gs' when installed into a public directory, to avoid name conflicts
       with other programs) links the font files from the X11 direcotry into the Ghostscript
       directory and automatically creates the description file ("Fontmap") in Ghostscript
       format.

       If the configuration file is not specified as an argument then the file `"convert.cfg"' in
       the current directory is used, just like the `"convert"' script does. Indeed, this
       configuration file is used for both scripts.

       The Ghostscript-related parameters in the configuration file are:

       "DSTDIR" - the X11 font directory used by `"x2gs"' as the source of the fonts. This
       parameter is common with the X11 configuration.

       "GSDIR" - the base directory of Ghostsript. If this parameter is set to an empty string
       then `"convert"' won't call `"x2gs"'. So if you want to get only the X11 fonts installed
       then set this parameter to an empty string. This directory may vary on various system, so
       please check your system and set this value accordingly before running the script.

       "GSFONTDIR" - the font directory of Ghostscript. In the standard Ghostscript installation
       it's a subdirectory of "GSDIR" but some systems may use completely different directories.

       "GSCONFDIR" - the configuration subdirectory of Ghostscript that contains the "Fontmap"
       file.

       "INSTALLFONTMAP" - if the value is set to "YES" then install the entries for the new fonts
       right into the main "Fontmap" file. Otherwise just leave the file "Fontmap.ttf" in the
       Ghostscript configuration directory.

       After preparing the configuration file run the script. It symbolicaly links all the font
       files and creates the description file "Fontmap.ttf" in "GSCONDFIR". After that there are
       two choices.

       If the option "INSTALLFONTMAP" was set to "YES" then the font descriptions are also
       automatically installed into the master "Fontmap" file. The script is clever enough to
       detect if it was run multiple times with the same directories and if so it replaces the
       old "Fontmap" entries with the new ones instead of just accumulating all of them. You may
       also run it multiple times for multiple X11 directories and all the results will be
       properly collected in the "Fontmap".  But it's your responsibility to watch that the names
       of the font files don't overlap. If the X11 font directory gets renamed then you have to
       remove its font entries from the "Fontmap" and only after that re-run `"x2gs"' for the new
       directory.

       On the other hand if the option "INSTALLFONTMAP" was set to "NO" then go to the
       "GSCONFDIR" directory and insert the contents of "Fontmap.ttf" into the "Fontmap" file
       manually. This step may be left manual to make the installation a little bit more safe.

       After that you may also want to redefine some of the aliases in "Fontmap" to refer to the
       newly installed fonts.  But the redefinition of the aliases may be dangerous if the width
       of characters in the new font will be different from the old font.  Alas, there is no
       visible solution of this problem yet.

FILES

       • TTF2UFM_SHAREDIR/scripts/convert.cfg.sample

       • TTF2UFM_SHAREDIR/scripts/*

       • TTF2UFM_SHAREDIR/README

       • TTF2UFM_SHAREDIR/FONTS

       • TTF2UFM_SHAREDIR/*

       • TTF2UFM_BINDIR/ttf2ufm

SEE ALSO

       •   ttf2ufm(1)

       •   ttf2ufm_convert(1)

       •   t1asm(1)