|
|
PHPlot: 5.0.6 released, PHPlot Reference Manual updated
01-23-2009
|
|
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)