1MKFONTSCALE(1)              General Commands Manual             MKFONTSCALE(1)
2
3
4

NAME

6       mkfontscale - create an index of scalable font files for X
7

SYNOPSIS

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

DESCRIPTION

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
19       The resulting fonts.scale file should be checked and possibly  manually
20       edited before being used as input for the mkfontdir(1) program.
21

OPTIONS

23       -b     read bitmap fonts.  By default, bitmap fonts are ignored.
24
25       -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
29       -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
36       -x suffix
37              exclude all files with the specified suffix.
38
39       -a encoding
40              add encoding to the list of encodings searched for.
41
42       -f fuzz
43              set  the  fraction  of  characters  that may be missing in large
44              encodings to fuzz percent.  Defaults to 2%.
45
46       -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
51       -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
55       -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
61       -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
65              options  is  significant,  as this option only applies to subse‐
66              quent -e options.
67
68       -n     do not scan for fonts, do not write font directory files.   This
69              option is useful when generating encoding directories only.
70
71       -u, -U disable  (-u) or enable (-U) indexing of ISO 10646:1 font encod‐
72              ings (default: enabled).
73
74       -v     print program version and exit.
75
76       --     end of options.
77

SEE ALSO

79       X(7), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)
80

NOTES

82       The format of the fonts.scale, fonts.dir  and  encodings.dir  files  is
83       documented in the mkfontdir(1) manual page.
84
85       Mkfontscale  will  overwrite  any  fonts.scale file even if it has been
86       hand-edited.
87
88       mkfontscale -b -s -l is equivalent to mkfontdir.
89

AUTHOR

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.
95
96
97
98X Version 11                   mkfontscale 1.1.3                MKFONTSCALE(1)
Impressum