STMKDIRS(1) X Version 11 STMKDIRS(1)
Release 5
NAME [Toc] [Back]
stmkdirs - Utility to build Scalable Type fonts.dir and charsets.dir
files
SYNOPSIS [Toc] [Back]
stmkdirs [options] directory [directory ...]
DESCRIPTION [Toc] [Back]
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
supported on a future release of the operating system.
Stmkdirs supports scalable typefaces as follows:
TrueType [Toc] [Back]
Stmkdirs can be used to generate fonts.dir files containing
entries for TrueType font files, and charsets.dir files
cataloging 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 [Toc] [Back]
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 [Toc] [Back]
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.
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.
Hewlett-Packard Company - 1 - HP-UX 10.0 July 1994
STMKDIRS(1) X Version 11 STMKDIRS(1)
Release 5
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
scalable fonts.
-o Requests that scalable fonts be excluded from any newly
generated 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
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, 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
configuration file is /etc/X11/fs/config. Stmkdirs uses the
"rasterizers=" line to determine the rasterizers used to
generate the font names from the font files.
-h Print usage information on stdout.
Hewlett-Packard Company - 2 - HP-UX 10.0 July 1994
STMKDIRS(1) X Version 11 STMKDIRS(1)
Release 5
-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", "subfamily", "unique", "full", "copyright",
"version", "trademark".
STMKDIRS VERSUS MKFONTDIR [Toc] [Back]
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.
EXAMPLES [Toc] [Back]
stmkdirs /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/typefaces directories.
SEE ALSO [Toc] [Back]
stlicense(1M), stload(1M)
COPYRIGHT [Toc] [Back]
Copyright 1990, Hewlett-Packard Company
See X(1) for a full statement of rights and permissions.
Hewlett-Packard Company - 3 - HP-UX 10.0 July 1994 [ Back ] |