Release 5

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 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 conform to 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).  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 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:

−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 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, 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. 

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 scalable fonts. 

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. 

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. 

Hewlett-Packard Company  —  HP-UX 9.0 August 1992