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 ] [ -u | -U ] [ -v ] [ -- ] [ 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.
28 -o filename
30 send program output to filename; default is fonts.scale if bit‐
31 map fonts are not being read, and fonts.dir if they are. If
32 filename is relative, it is created in the directory being pro‐
33 cessed. If it is the special value -, output is written to
34 standard output.
35 -x suffix
37 exclude all files with the specified suffix.
38 -a encoding
40 add encoding to the list of encodings searched for.
41 -f fuzz
43 set the fraction of characters that may be missing in large en‐
44 codings to fuzz percent. Defaults to 2%.
45 -l Write fonts.dir files suitable for implementations that cannot
47 reencode legacy fonts (BDF and PCF). By default, it is assumed
48 that the implementation can reencode Unicode-encoded legacy
49 fonts.
50 -e specifies a directory with encoding files. Every such directory
52 is scanned for encoding files, the list of which is then written
53 to an "encodings.dir" file in every font directory.
54 -p Specifies a prefix that is prepended to the encoding file path
56 names when they are written to the "encodings.dir" file. The
57 prefix is prepended literally: if a `/' is required between the
58 prefix and the path names, it must be supplied explicitly as
59 part of the prefix.
60 -r Keep non-absolute encoding directories in their relative form
62 when writing the "encodings.dir" file. The default is to con‐
63 vert relative encoding directories to absolute directories by
64 prepending the current directory. The positioning of this op‐
65 tions is significant, as this option only applies to subsequent
66 -e options.
67 -n do not scan for fonts, do not write font directory files. This
69 option is useful when generating encoding directories only.
70 -u, -U disable (-u) or enable (-U) indexing of ISO 10646:1 font encod‐
72 ings (default: enabled).
73 -v print program version and exit.
75 -- end of options.
77
79 X(7), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)
80
82 The format of the fonts.scale, fonts.dir and encodings.dir files is
83 documented in the mkfontdir(1) manual page.
84 Mkfontscale will overwrite any fonts.scale file even if it has been
86 hand-edited.
87 mkfontscale -b -s -l is equivalent to mkfontdir.
89
91 The version of mkfontscale included in this X.Org Foundation release
92 was originally written by Juliusz Chroboczek <jch@freedesktop.org> for
93 the XFree86 project. The functionality of this program was inspired by
94 the ttmkfdir utility by Joerg Pommnitz.
95X Version 11 mkfontscale 1.2.1 MKFONTSCALE(1)