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 ] ...
MKFONTSCALE(1) General Commands Manual MKFONTSCALE(1)
NAME
mkfontscale - create an index of scalable font files for X
SYNOPSIS
mkfontscale [ -b ] [ -s ] [ -o filename ] [ -x suffix ] [ -a encoding ]
... [ -f fuzz ] [ -l ] [ -e directory ] [ -p prefix ] [ -r prefix ] [
-n prefix ] [ -u | -U ] [ -v ] [ -- ] [ directory ] ...
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 possibly 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 bit-
map fonts are not being read, and fonts.dir if they are. If
filename is relative, it is created in the directory being pro-
cessed. 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 con-
vert relative encoding directories to absolute directories by
prepending the current directory. The positioning of this
options is significant, as this option only applies to subse-
quent -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 encod-
ings (default: enabled).
-v print program version and exit.
-- end of options.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------+
|Availability | x11/font-utilities |
+---------------+--------------------+
|Stability | Volatile |
+---------------+--------------------+
SEE ALSO
X(7), 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.
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from ['https://www.x.org/releases/individ-
ual/app/mkfontscale-1.2.1.tar.bz2', 'https://www.x.org/releases/indi-
vidual/app/bdftopcf-1.1.tar.bz2', 'https://www.x.org/releases/individ-
ual/font/font-util-1.3.2.tar.bz2'].
Further information about this software can be found on the open source
community website at https://www.x.org.
AUTHOR
The version of mkfontscale included in this X.Org Foundation release
was originally written by Juliusz Chroboczek <jch@freedesktop.org> for
the XFree86 project. The functionality of this program was inspired by
the ttmkfdir utility by Joerg Pommnitz.
X Version 11 mkfontscale 1.2.1 MKFONTSCALE(1)