User Commands MKFONTSCALE(1)
NAME
mkfontscale - create an index of scalable font files for X
SYNOPSIS
/usr/bin/mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suf-
fix ] [ -a encoding ] ... [ -f fuzz ] [ -l ] [ -e directory
] [ -p prefix ] [ -r prefix ] [ -n prefix ] [ -- ] [ direc-
tory ] ...
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 possi-
bly 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
X Version 11 Last change: mkfontscale 1.0.7 1
User Commands MKFONTSCALE(1)
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 rela-
tive form when writing the "encodings.dir" file. The
default is to convert relative encoding directories to
absolute directories by prepending the current direc-
tory. 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.
-- end of options.
SEE ALSO
X(5), 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
for the XFree86 project. The func-
tionality of this program was inspired by the ttmkfdir util-
ity by Joerg Pommnitz.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
X Version 11 Last change: mkfontscale 1.0.7 2
User Commands MKFONTSCALE(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/font-utilities |
|_____________________________|_____________________________|
| Interface Stability | Uncommitted |
|_____________________________|_____________________________|
X Version 11 Last change: mkfontscale 1.0.7 3