STMKDIRS(1)STMKDIRS(1)NAMEstmkdirs - Utility to build Scalable Type fonts.dir and charsets.dir
files
SYNOPSISstmkdirs [options] directory [directory ...]
DESCRIPTION
The stmkdirs utility is used to support TrueType, Type1 and Intellifont
scalable fonts. It creates the fonts.dir, and charsets.dir files used
by the Font Server and Scalable Type subsystem.
Intellifont scalable fonts are being obsoleted and will not be sup‐
ported on a future release of the operating system.
Stmkdirs supports scalable typefaces as follows:
TrueType
Stmkdirs can be used to generate fonts.dir files containing
entries for TrueType font files, and charsets.dir files cata‐
loging character sets for TrueType fonts. TrueType font files
contain the suffix ".ttf".
Type 1 Stmkdirs can generate fonts.dir files containing entries for
Type 1 outline files. Type 1 font files contain the suffix
".pfa".
Intellifont
Stmkdirs can be used to generate fonts.dir files containing
entries for Intellifont outline files, and charsets.dir files
cataloging character sets for Intellifont fonts. Intellifont
font files contain the suffix ".ifo".
OPTIONS
There are several command line options which are described below.
directory
This specifies the names of one or more directories to be pro‐
cessed. At least one directory parameter must be specified.
Stmkdirs will create whatever .dir files are needed in a direc‐
tory: if a directory contains bitmapped fonts or font out‐
lines, it will create or update fonts.dir; if character set
files, charsets.dir.
The default behavior of stmkdirs is to attempt to generate complete
fonts.dir, and charsets.dir files in all directories specified. You
can cause certain items to not be generated or included in the final
files by using ``-'' suppression options. Similarly, to generate only
certain items, you should use one or more ``+'' options.
The command line is processed from left to right, making it possible
for you to apply different options to different directories all in the
same command. To avoid confusing behavior you should therefore take
care to specify all switch options before specifying directory names.
Data inclusion and exclusion switches include:
+c Requests that charsets.dir be generated.
-c Requests that charsets.dir not be generated.
+f Requests that fonts.dir be generated and should include .ifo
scalable typeface libraries as well as other bitmap fonts
(those normally found by mkfontdir). This is equivalent to
requesting +mo.
-f Requests that fonts.dir not be generated.
+m Requests that fonts.dir be generated and should include bitmap
fonts (those normally found by mkfontdir).
-m Requests that bitmap fonts (those normally found by mkfontdir)
be excluded from any newly generated fonts.dir.
+o Requests that fonts.dir be generated and should include scal‐
able fonts.
-o Requests that scalable fonts be excluded from any newly gener‐
ated fonts.dir.
Additional switches include:
-a Ensures that any symbol set catalogued in charsets.dir can be
used with any .ifo scalable typeface library catalogued in
fonts.dir. (Normally, the Font Server recognizes only combina‐
tions in which the typeface library actually contains all or
most of the glyphs specified by the symbol set.)
-b Suppress creation of backup files. Normally, whenever stmkdirs
constructs a new fonts.dir, or charsets.dir file, any pre-
existing old version of that file is renamed (to its original
name with a tilde ``~'' appended) rather than overwritten. The
-b option disables this feature.
-config configfile
Specifies the configuration file to be used. The default con‐
figuration file is /etc/X11/fs/config. Stmkdirs uses the "ras‐
terizers=" line to determine the rasterizers used to generate
the font names from the font files.
-h Print usage information on stdout.
-T name This is a TrueType (.ttf file) only option. Name specifies the
element of the name table to be used to build the family name.
Possible values are "family" (the default), "postscript", "sub‐
family", "unique", "full", "copyright", "version", "trademark".
STMKDIRS VERSUS MKFONTDIR
When generating fonts.dir files, stmkdirs acts like an extended version
of the mkfontdir(1) utility. In addition to recognizing the bitmapped
font files handled by mkfontdir, stmkdirs recognizes TrueType (.ttf),
Type 1 (.pfa), and Intellifont (.ifo) font files, and adds entries for
them to the fonts.dir file.
As with mkfontdir, the fonts.scale can be used to add entries for file
types not recognized by stmkdirs. However, fonts.scale is not needed
for TrueType, Type1 or Intellifont scalable fonts.
EXAMPLESstmkdirs /usr/lib/X11/fonts/ms.st/typefaces
Requests that fonts.dir and, if appropriate, charsets.dir files
be built in /usr/lib/X11/fonts/ms.st/typefaces.
stmkdirs /usr/lib/X11/fonts/type1.st/typefaces
Generates a fonts.dir in the /usr/lib/X11/fonts/type1.st/type‐
faces directories.
SEE ALSOstlicense(1M), stload(1M)COPYRIGHT
Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
X Version 11 Release 5 STMKDIRS(1)