unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 STMKDIRS(1)			X Version 11			 STMKDIRS(1)
				  Release 5



 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
	      cataloging 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 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
      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.






















 Hewlett-Packard Company	    - 3 -		HP-UX 10.0 July 1994