1MKFONTSCALE(1) General Commands Manual MKFONTSCALE(1)
2
6 mkfontscale - create an index of scalable font files for X
7
9 mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suffix ] [ -a encoding ]
10 ... [ -f fuzz ] [ -l ] [ -e directory ] [ -p prefix ] [ -r prefix ] [
11 -n prefix ] [ -- ] [ directory ] ...
12
14 For each directory argument, mkfontscale reads all of the scalable font
15 files in the directory. For every font file found, an X11 font name
16 (XLFD) is generated, and is written together with the file name to a
17 file fonts.scale in the directory.
18 The resulting fonts.scale file should be checked and possibly manually
20 edited before being used as input for the mkfontdir(1) program.
21
23 -b read bitmap fonts. By default, bitmap fonts are ignored.
24 -s ignore scalable fonts. By default, scalable fonts are read. If
26 -b is set, this flag has the side effect of enabling the reading
27 of fonts.scale files. -o filename send program output to file‐
28 name; default is fonts.scale if bitmap fonts are not being read,
29 and fonts.dir if they are. If filename is relative, it is cre‐
30 ated in the directory being processed. If it is the special
31 value -, output is written to standard output.
32 -x suffix
34 exclude all files with the specified suffix
35 -a encoding
37 add encoding to the list of encodings searched for.
38 -f fuzz
40 set the fraction of characters that may be missing in large
41 encodings to fuzz percent. Defaults to 2%.
42 -l Write fonts.dir files suitable for implementations that cannot
44 reencode legacy fonts (BDF and PCF). By default, it is assumed
45 that the implementation can reencode Unicode-encoded legacy
46 fonts.
47 -e specifies a directory with encoding files. Every such directory
49 is scanned for encoding files, the list of which is then written
50 to an "encodings.dir" file in every font directory.
51 -p Specifies a prefix that is prepended to the encoding file path
53 names when they are written to the "encodings.dir" file. The
54 prefix is prepended litterally: if a `/' is required between the
55 prefix and the path names, it must be supplied explicitly as
56 part of the prefix.
57 -r Keep non-absolute encoding directories in their relative form
59 when writing the "encodings.dir" file. The default is to con‐
60 vert relative encoding directories to absolute directories by
61 prepending the current directory. The positioning of this
62 options is significant, as this option only applies to subse‐
63 quent
64 -n do not scan for fonts, do not write font directory files. This
66 option is useful when generating encoding directories only.
67 -- end of options.
69
71 X(7), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)
72
74 The format of the fonts.scale, fonts.dir and encodings.dir files is
75 documented in the mkfontdir(1) manual page.
76 Mkfontscale will overwrite any fonts.scale file even if it has been
78 hand-edited.
79 mkfontscale -b -s -l is equivalent to mkfontdir.
81
83 The version of mkfontscale included in this X.Org Foundataion release
84 was originally written by Juliusz Chroboczek <jch@xfree86.org> for the
85 XFree86 project. The functionality of this program was inspired by the
86 ttmkfdir utility by Joerg Pommnitz.
87X Version 11 mkfontscale 1.0.1 MKFONTSCALE(1)