MKFONTSCALE(1)                                     MKFONTSCALE(1)


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

SYNOPSIS
       mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suffix ]  [
       -a encoding ] ... [ -f fuzz ] [ -l ] [ -e directory ] [ -p
       prefix ] [ -r prefix ] [ -n prefix ] [ -- ] [ 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 writ-
       ten together with the file name to a file  fonts.scale  in
       the directory.

       The  resulting fonts.scale file should be checked and pos-
       sibly 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 stan-
              dard 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



X Version 11            mkfontscale 1.0.5                       1





MKFONTSCALE(1)                                     MKFONTSCALE(1)


              such  directory  is scanned for encoding files, the
              list of which is then written to an "encodings.dir"
              file in every font directory.

       -p     Specifies  a prefix that is prepended to the encod-
              ing file path names when they are  written  to  the
              "encodings.dir" file.  The prefix is prepended lit-
              erally: 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
              relative  form  when  writing  the  "encodings.dir"
              file.  The default is to convert relative  encoding
              directories  to  absolute directories by prepending
              the current directory.   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.

       --     end of options.

SEE ALSO
       X(7),  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 Founda-
       tion release was originally written by Juliusz  Chroboczek
       <jchATfreedesktop.org>  for the XFree86 project.  The func-
       tionality of this program was  inspired  by  the  ttmkfdir
       utility by Joerg Pommnitz.













X Version 11            mkfontscale 1.0.5                       2