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 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 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 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
- -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 <jch@xfree86.org> for the XFree86
project. The functionality of this program was inspired by the
ttmkfdir utility by Joerg Pommnitz.