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
mkfontdir(1) program.
- -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 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.
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 page.
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 protected]> for the
XFree86 project. The functionality of this program was inspired by the
ttmkfdir utility by Joerg Pommnitz.