STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
NAME
stmkdirs - Utility to build Scalable Type ``.dir'' and
``.tfm'' files.
SYNOPSIS
stmkdirs [options] directory [directory ...]
DESCRIPTION
The stmkdirs utility creates the fonts.dir, charsets.dir,
and metrics.dir files required by the Scalable Type subsys-
tem. It additionally can be used to construct Tagged Font
Metrics .tfm files to complement a set of Scalable Typeface
outline libraries. Stload, the Scalable Typeface installa-
tion utility, routinely runs stmkdirs as the final step in
the installation of a new typeface.
OPTIONS
There are several command line options which are described
below.
directory
This specifies the names of one or more directories
to be processed. At least one directory parameter
must be specified. Stmkdirs will create whatever
.dir files are needed in a directory: if a direc-
tory contains bitmapped fonts or font outlines, it
will create or update fonts.dir; if character set
files, charsets.dir; if TFM files, metrics.dir.
-d directory
Specifies the directory containing default character
set (.sym) files and the symbol list map (such as
ACG-HPMSL) required by the -tfm directory option in
order to construct TFM files. If left unspecified,
stmkdirs assumes the this directory to be
/usr/lib/X11/fonts/stadmin/ifo/charsets. Character
set files will be taken from this directory only if
none are found in any of the processed directories.
-sl syms
The -sl switch informs stmkdirs that the font
library (.ifo) files being processed contain some
symbol list other than HP Master Symbol List
(HPMSL). This information is necessary for genera-
tion of correct TFM files. For example, for a font
loaded by stload with the ACG symbol list, -sl ACG
should be used in the stmkdirs invocation to ensure
placing correct information in the TFM files.
-tfm directory
The -tfm switch instructs stmkdirs to build Tagged
Font Metrics (TFM) files in the specified directory.
Printed 2/15/92 Release 4 1
STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
TFM files contain font metrics information used by
some applications to determine information such as
character spacing. Data in the TFM files is gleaned
from typeface library .ifo files and from character
set .sym files; TFM files will not be built if
stmkdirs does not find the required library and
character set files. (If stmkdirs does not find
character set files in any of the directories it
processes, it will use the character set files in
/usr/lib/X11/fonts/stadmin/ifo/charsets unless
pointed elsewhere via the -d option).
The default behavior of stmkdirs is to attempt to generate
complete fonts.dir, charsets.dir, and metrics.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 cer-
tain 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 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
-o Requests that .ifo scalable typeface libraries be
excluded from any newly generated fonts.dir.
+r Requests that metrics.dir be generated.
Printed 2/15/92 Release 4 2
STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
-r Requests that metrics.dir not be generated.
Additional switches include:
-b Suppress creation of backup files. Normally, when-
ever stmkdirs constructs a new fonts.dir,
charsets.dir, or metrics.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.
-h Print usage information on stdout.
EXAMPLES
/usr/lib/X11/fonts/ifo.st/typefaces
stmkdirs -tfm /usr/lib/X11/fonts/ifo.st/metrics
Requests that fonts.dir and, if appropriate,
charsets.dir files be built in
/usr/lib/X11/fonts/ifo.st/typefaces. In addition,
the -tfm switch requests that .tfm files plus an
appropriate metrics.dir file be built in
/usr/lib/X11/fonts/ifo.st/metrics.
SEE ALSO
stlicense(1M), stmkfont(1), stload(1M)
COPYRIGHT
Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
Printed 2/15/92 Release 4 3