244 lines
7.2 KiB
HTML
244 lines
7.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MKFONTDIR</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MKFONTDIR</H1>
|
|
Section: User Commands (1)<BR>Updated: mkfontdir 1.0.7<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
mkfontdir - create an index of X font files in a directory
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>mkfontdir</B>
|
|
|
|
[<B>-n</B>]
|
|
|
|
[<B>-x</B>
|
|
|
|
<I>suffix</I>]
|
|
|
|
[<B>-r</B>]
|
|
|
|
[<B>-p</B>
|
|
|
|
<I>prefix</I>]
|
|
|
|
[<B>-e</B>
|
|
|
|
<I>encoding-directory-name</I>]
|
|
|
|
...
|
|
[<B>--</B>]
|
|
|
|
[<I>directory-name</I>
|
|
|
|
... ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
For each directory argument,
|
|
<I>mkfontdir</I>
|
|
|
|
reads all of the font files in the
|
|
directory searching for properties named "FONT", or (failing that) the name
|
|
of the file stripped of its suffix. These are converted to lower case and
|
|
used as font names, and,
|
|
along with the name of the font file, are
|
|
written out to the file "fonts.dir" in the directory.
|
|
The X server and font server use "fonts.dir" to find font files.
|
|
<P>
|
|
|
|
The kinds of font files read by
|
|
<I>mkfontdir</I>
|
|
|
|
depend on configuration
|
|
parameters, but typically include PCF (suffix ".pcf"), SNF (suffix ".snf")
|
|
and BDF (suffix ".bdf"). If a font exists in multiple formats,
|
|
<I>mkfontdir</I>
|
|
|
|
will first choose PCF, then SNF and finally BDF.
|
|
<P>
|
|
|
|
The first line of fonts.dir gives the number of fonts in the file.
|
|
The remaining lines list the fonts themselves, one per line, in two
|
|
fields. First is the name of the font file, followed by a space and
|
|
the name of the font.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>SCALABLE FONTS</H2>
|
|
|
|
Because scalable font files do not usually include the X font name, the
|
|
file "fonts.scale" can be used to name the scalable fonts in the
|
|
directory.
|
|
The fonts listed in it are copied to fonts.dir by
|
|
<I>mkfontdir</I>.
|
|
|
|
"fonts.scale" has the same format as the "fonts.dir" file, and can be
|
|
created with the
|
|
<I><A HREF="/cgi-bin/man/man2html?1+mkfontscale">mkfontscale</A></I>(1)
|
|
|
|
program.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FONT NAME ALIASES</H2>
|
|
|
|
The file "fonts.alias", which can be put in any directory of the font-path, is
|
|
used to map new names to existing fonts, and should be edited by hand. The
|
|
format is two white-space separated columns, the
|
|
first containing aliases and the second containing font-name patterns.
|
|
Lines beginning with "!" are comment lines and are ignored.
|
|
<P>
|
|
|
|
If neither the alias nor the value specifies the size fields of the
|
|
font name, this is a scalable alias. A font name of any size that
|
|
matches this alias will be mapped to the same size of the font that
|
|
the alias resolves to.
|
|
<P>
|
|
|
|
When a font alias is used, the name it references is searched for in the normal
|
|
manner, looking through each font directory in turn. This means that the
|
|
aliases need not mention fonts in the same directory as the alias file.
|
|
<P>
|
|
|
|
To embed white space in either name, simply enclose it in double-quote
|
|
marks; to embed double-quote marks (or any other character), precede them
|
|
with back-slash:
|
|
<P>
|
|
|
|
<PRE>
|
|
"magic-alias with spaces" "\"font name\" with quotes"
|
|
regular-alias fixed
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
If the string "FILE_NAMES_ALIASES" stands alone on a line, each file-name
|
|
in the directory (stripped of its suffix) will be used as an alias for
|
|
that font.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENCODING FILES</H2>
|
|
|
|
The option
|
|
<B>-e</B>
|
|
|
|
can be used to specify 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. The
|
|
"encodings.dir" file is used by the server to find encoding
|
|
information.
|
|
<P>
|
|
|
|
The "encodings.dir" file has the same format as "fonts.dir".
|
|
It maps encoding names (strings of the form
|
|
<B>CHARSET_REGISTRY</B><I>-</I><B>CHARSET_ENCODING</B>
|
|
|
|
) to encoding file names.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
The following options are supported:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-e</B>
|
|
|
|
<DD>
|
|
Specify a directory containing encoding files. The
|
|
<B>-e</B>
|
|
|
|
option may be specified multiple times, and all the specified
|
|
directories will be read. The order of the entries is significant, as
|
|
encodings found in earlier directories override those in later ones;
|
|
encoding files in the same directory are discriminated by preferring
|
|
compressed versions.
|
|
<DT id="2"><B>-n</B>
|
|
|
|
<DD>
|
|
do not scan for fonts, do not write font directory files. This option
|
|
is useful when generating encoding directories only.
|
|
<DT id="3"><B>-p</B>
|
|
|
|
<DD>
|
|
Specify a prefix that is prepended to the encoding file path names
|
|
when they are written to the "encodings.dir" file. The prefix is
|
|
prepended as-is. If a `/' is required between the prefix and the path
|
|
names, it must be supplied explicitly as part of the prefix.
|
|
<DT id="4"><B>-r</B>
|
|
|
|
<DD>
|
|
Keep non-absolute encoding directories in their relative form when
|
|
writing the "encodings.dir" file. The default is to convert relative
|
|
encoding directories to absolute directories by prepending the current
|
|
directory. The positioning of this options is significant, as this
|
|
option only applies to subsequent
|
|
<B>-e</B>
|
|
|
|
options.
|
|
<DT id="5"><B>-x </B><I>suffix</I>
|
|
|
|
<DD>
|
|
Ignore fonts files of type
|
|
<I>suffix</I>.
|
|
|
|
<DT id="6"><B>--</B>
|
|
|
|
<DD>
|
|
End options.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>fonts.dir</B>
|
|
|
|
<DD>
|
|
List of fonts in the directory and the files they are stored in.
|
|
Created by <I>mkfontdir</I>. Read by the X server and font server each
|
|
time the font path is set (see <A HREF="/cgi-bin/man/man2html?1+xset">xset</A>(1)).
|
|
<DT id="8"><B>fonts.scale</B>
|
|
|
|
<DD>
|
|
List of scalable fonts in the directory. Contents are copied to
|
|
fonts.dir by <I>mkfontdir</I>. Can be created with
|
|
<I><A HREF="/cgi-bin/man/man2html?1+mkfontscale">mkfontscale</A></I>(1).
|
|
|
|
<DT id="9"><B>fonts.alias</B>
|
|
|
|
<DD>
|
|
List of font name aliases.
|
|
Read by the X server and font server each
|
|
time the font path is set (see <A HREF="/cgi-bin/man/man2html?1+xset">xset</A>(1)).
|
|
<DT id="10"><B>encodings.dir</B>
|
|
|
|
<DD>
|
|
List of known encodings and the files they are stored in.
|
|
Created by <I>mkfontdir</I>. Read by the X server and font server each
|
|
time a font with an unknown charset is opened.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+Xserver">Xserver</A>(1), <A HREF="/cgi-bin/man/man2html?1+mkfontscale">mkfontscale</A>(1), <A HREF="/cgi-bin/man/man2html?1+xfs">xfs</A>(1), <A HREF="/cgi-bin/man/man2html?1+xset">xset</A>(1)
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">SCALABLE FONTS</A><DD>
|
|
<DT id="15"><A HREF="#lbAF">FONT NAME ALIASES</A><DD>
|
|
<DT id="16"><A HREF="#lbAG">ENCODING FILES</A><DD>
|
|
<DT id="17"><A HREF="#lbAH">OPTIONS</A><DD>
|
|
<DT id="18"><A HREF="#lbAI">FILES</A><DD>
|
|
<DT id="19"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|