mkfontscale (1)

Name

mkfontscale - create an index of scalable font files for X

Synopsis

/usr/bin/mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suf-
fix ] [ -a encoding ] ... [ -f fuzz ] [ -l ] [ -e  directory
] [ -p prefix ] [ -r prefix ] [ -n prefix ] [ -u | -U ] [ --
] [ directory ] ...

Description

User Commands                                      MKFONTSCALE(1)



NAME
     mkfontscale - create an index of scalable font files for X

SYNOPSIS
     /usr/bin/mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suf-
     fix ] [ -a encoding ] ... [ -f fuzz ] [ -l ] [ -e  directory
     ] [ -p prefix ] [ -r prefix ] [ -n prefix ] [ -u | -U ] [ --
     ] [ directory ] ...

DESCRIPTION
     For each directory argument, mkfontscale reads  all  of  the
     scalable  font  files in the directory.  For every font file
     found, an X11 font name (XLFD) is generated, and is  written
     together  with  the  file  name to a file fonts.scale in the
     directory.

     The resulting fonts.scale file should be checked and  possi-
     bly  manually  edited  before  being  used  as input for the
     mkfontdir(1) program.

OPTIONS
     -b   read  bitmap  fonts.   By  default,  bitmap  fonts  are
          ignored.

     -s   ignore  scalable fonts.  By default, scalable fonts are
          read.  If -b is set, this flag has the side  effect  of
          enabling the reading of fonts.scale files.

     -o filename
          send program output to filename; default is fonts.scale
          if bitmap fonts are not being read,  and  fonts.dir  if
          they  are.   If  filename is relative, it is created in
          the directory being processed.  If it  is  the  special
          value -, output is written to standard output.

     -x suffix
          exclude all files with the specified suffix.

     -a encoding
          add encoding to the list of encodings searched for.

     -f fuzz
          set  the  fraction of characters that may be missing in
          large encodings to fuzz percent.  Defaults to 2%.

     -l   Write fonts.dir files suitable for implementations that
          cannot   reencode  legacy  fonts  (BDF  and  PCF).   By
          default, it is  assumed  that  the  implementation  can
          reencode Unicode-encoded legacy fonts.

     -e   specifies  a directory with encoding files.  Every such
          directory is scanned for encoding files,  the  list  of



X Version 11      Last change: mkfontscale 1.1.1                1






User Commands                                      MKFONTSCALE(1)



          which  is  then  written  to an "encodings.dir" file in
          every font directory.

     -p   Specifies a prefix that is prepended  to  the  encoding
          file  path  names  when they are written to the "encod-
          ings.dir" file.  The prefix is prepended literally:  if
          a  `/'  is  required  between  the  prefix and the path
          names, it must be supplied explicitly as  part  of  the
          prefix.

     -r   Keep  non-absolute  encoding directories in their rela-
          tive form when writing the "encodings.dir"  file.   The
          default  is to convert relative encoding directories to
          absolute directories by prepending the  current  direc-
          tory.   The positioning of this options is significant,
          as this option only applies to subsequent -e options.

     -n   do not scan for fonts,  do  not  write  font  directory
          files.   This option is useful when generating encoding
          directories only.

     -u, -U
          disable (-u) or enable (-U)  indexing  of  ISO  10646:1
          font encodings (default: enabled).

     --   end of options.

SEE ALSO
     X(5), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)

NOTES
     The format of the fonts.scale, fonts.dir  and  encodings.dir
     files is documented in the mkfontdir(1) manual page.

     Mkfontscale  will  overwrite any fonts.scale file even if it
     has been hand-edited.

     mkfontscale -b -s -l is equivalent to mkfontdir.

AUTHOR
     The version of mkfontscale included in this X.Org Foundation
     release   was   originally  written  by  Juliusz  Chroboczek
     <[email protected]> for the XFree86  project.   The  func-
     tionality of this program was inspired by the ttmkfdir util-
     ity by Joerg Pommnitz.


ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:





X Version 11      Last change: mkfontscale 1.1.1                2






User Commands                                      MKFONTSCALE(1)



     +-----------------------------+-----------------------------+
     |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
     +-----------------------------+-----------------------------+
     |Availability                 |x11/font-utilities           |
     +-----------------------------+-----------------------------+
     |Interface Stability          |Uncommitted                  |
     +-----------------------------+-----------------------------+
















































X Version 11      Last change: mkfontscale 1.1.1                3