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 ] [ -u | -U ] [ -v ] [ --  ]
       [ 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 possibly 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 re-encode legacy
              fonts (BDF and PCF).  By default, it is assumed that  the  implementation  can  re-
              encode Unicode-encoded legacy fonts.

       -e     specifies  a  directory  with  encoding files.  Every 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 encoding file path names when they are
              written to the "encodings.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  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.

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

       -v     print program version and exit.

       --     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  Foundation  release  was  originally
       written  by  Juliusz  Chroboczek  <jch@freedesktop.org>  for  the  XFree86  project.   The
       functionality of this program was inspired by the ttmkfdir utility by Joerg Pommnitz.