STMKDIRS(1)						      General Commands Manual						       STMKDIRS(1)

NAME

       stmkdirs - Utility to build Scalable Type fonts.dir and charsets.dir files

SYNOPSIS

       stmkdirs [options] directory [directory ...]

DESCRIPTION

       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
	       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
	       Stmkdirs  can  be  used	to generate fonts.dir files containing entries for Intellifont outline files, and charsets.dir files cata-
	       loging character sets for Intellifont fonts.  Intellifont font files contain the suffix ".ifo".

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 cre-
	       ate 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.

       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 nor-
	       mally 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 dis-
	       ables this feature.

       -config configfile
	       Specifies the configuration file to be used.  The default configuration file is /etc/X11/fs/config.  Stmkdirs uses  the	"rasteriz-
	       ers=" line to determine the rasterizers used to generate the font names from the font files.

       -h      Print usage information on stdout.

       -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

       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

       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

       stlicense(1M), stload(1M)

COPYRIGHT

       Copyright 1990, Hewlett-Packard Company
       See X(1) for a full statement of rights and permissions.

X Version 11							     Release 5							       STMKDIRS(1)