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 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 file
	      name; default is fonts.scale if bitmap fonts are not being read,
	      and  fonts.dir if they are.  If filename is relative, it is cre
	      ated 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 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 litterally: 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  con
	      vert  relative  encoding	directories to absolute directories by
	      prepending the  current  directory.   The  positioning  of  this
	      options  is  significant,  as this option only applies to subse
	      quent

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



X Version 11		       mkfontscale 1.0.1		MKFONTSCALE(1)