mkfontscale - create an index of scalable font files for X
mkfontscale [ -b ] [ -s ] [ -o
filename ] [ -x suffix ] [ -a encoding ]
... [ -f fuzz ] [ -l ] [ -e directory ] [
-p prefix ] [ -r prefix ] [ -n
prefix ] [ -u | -U ] [ -v ] [ -- ] [
directory ] ...
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
- read bitmap fonts. By default, bitmap fonts are ignored.
- ignore scalable fonts. By default, scalable fonts are read. If -b
is set, this flag has the side effect of enabling the reading of
- -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
- -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%.
- 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.
- 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.
- 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.
- 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.
- 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).
- print program version and exit.
- end of options.
X(7), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)
The format of the fonts.scale, fonts.dir and
encodings.dir files is documented in the mkfontdir(1) manual
Mkfontscale will overwrite any fonts.scale file even
if it has been hand-edited.
mkfontscale -b -s -l is equivalent to mkfontdir.
The version of mkfontscale included in this X.Org
Foundation release was originally written by Juliusz Chroboczek
<email@example.com> for the XFree86 project. The functionality of
this program was inspired by the ttmkfdir utility by Joerg