Release 4

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 subsystem.  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 installation 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 directory 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 generation 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). 

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 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 .ifo 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:

−b Suppress creation of backup files.  Normally, whenever 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

stmkdirs -tfm /usr/lib/X11/fonts/ifo.st/metrics /usr/lib/X11/fonts/ifo.st/typefaces
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. 

  —  November 10, 1991