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 is used to support Intellifont and Type
1 scalable fonts. It creates the fonts.dir, charsets.dir,
and metrics.dir files used by the Font Server and Scalable
Type subsystem.
Stmkdirs supports scalable typefaces as follows:
Intellifont
Stmkdirs can be used to generate fonts.dir files
containing entries for Intellifont outline files,
charsets.dir files cataloging character sets for
Intellifont fonts, Tagged Font Metrics (.tfm) files
describing font metrics for Intellifont outlines,
and metrics.dir files cataloging .tfm files.
Type 1 Stmkdirs can generate fonts.dir files containing
entries for Type 1 outline files.
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 conform to some
HP-UX 9.0 August 1992 Release 5 1
STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
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.
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). TFM files are
generated only for Intellifont outlines.
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).
HP-UX 9.0 August 1992 Release 5 2
STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
-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 scalable typeface libraries.
-o Requests that .ifo scalable typeface libraries be
excluded from any newly generated fonts.dir.
+r Requests that metrics.dir be generated.
-r Requests that metrics.dir not be generated.
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. (Nor-
mally, the Font Server recognizes only combinations
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, 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.
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 Intellifont (.ifo) and Type 1
(.pfa and .pfb) 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 Intellifont and Type 1 scal-
able fonts.
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
HP-UX 9.0 August 1992 Release 5 3
STMKDIRS(1) UNIX Programmer's Manual STMKDIRS(1)
appropriate metrics.dir file be built in
/usr/lib/X11/fonts/ifo.st/metrics.
stmkdirs /usr/lib/X11/fonts/type1.st/typefaces
Generates a fonts.dir in the
/usr/lib/X11/fonts/type1.st/typefaces directories.
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.
HP-UX 9.0 August 1992 Release 5 4