man-pages/man1/mkfontscale.1.html
2021-03-31 01:06:50 +01:00

272 lines
5.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of MKFONTSCALE</TITLE>
</HEAD><BODY>
<H1>MKFONTSCALE</H1>
Section: User Commands (1)<BR>Updated: mkfontscale 1.1.3<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
mkfontscale - create an index of scalable font files for X
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>mkfontscale</B>
[
<B>-b</B>
] [
<B>-s</B>
] [
<B>-o</B>
<I>filename</I>
] [
<B>-x</B>
<I>suffix</I>
] [
<B>-a</B>
<I>encoding</I>
] ... [
<B>-f</B>
<I>fuzz</I>
] [
<B>-l</B>
] [
<B>-e</B>
<I>directory</I>
] [
<B>-p</B>
<I>prefix</I>
] [
<B>-r</B>
<I>prefix</I>
] [
<B>-n</B>
<I>prefix</I>
] [
<B>-u | -U</B>
] [
<B>-v</B>
] [
<B>--</B>
] [
<I>directory</I>
] ...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
For each directory argument,
<I>mkfontscale</I>
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
<B>fonts.scale</B>
in the directory.
<P>
The resulting
<B>fonts.scale</B>
file should be checked and possibly manually edited before being used
as input for the
<B><A HREF="/cgi-bin/man/man2html?1+mkfontdir">mkfontdir</A></B>(1)
program.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-b</B>
<DD>
read bitmap fonts. By default, bitmap fonts are ignored.
<DT id="2"><B>-s</B>
<DD>
ignore scalable fonts. By default, scalable fonts are read. If
<B>-b</B>
is set, this flag has the side effect of enabling the reading of
<B>fonts.scale</B>
files.
<DT id="3"><B>-o</B><I> filename</I>
<DD>
send program output to
<I>filename</I>;
default is
<B>fonts.scale</B>
if bitmap fonts are not being read, and
<B>fonts.dir</B>
if they are. If
<I>filename</I>
is relative, it is created in the directory being processed. If it is
the special value
<B>-</B>,
output is written to standard output.
<DT id="4"><B>-x</B><I> suffix</I>
<DD>
exclude all files with the specified
<I>suffix</I>.
<DT id="5"><B>-a</B><I> encoding</I>
<DD>
add
<I>encoding</I>
to the list of encodings searched for.
<DT id="6"><B>-f</B><I> fuzz</I>
<DD>
set the fraction of characters that may be missing in large encodings to
<I>fuzz</I>
percent. Defaults to 2%.
<DT id="7"><B>-l</B>
<DD>
Write
<B>fonts.dir</B>
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.
<DT id="8"><B>-e</B>
<DD>
specifies a directory with encoding files. Every such
directory is scanned for encoding files, the list of which is then
written to an &quot;encodings.dir&quot; file in every font directory.
<DT id="9"><B>-p</B>
<DD>
Specifies a prefix that is prepended to the encoding file path names
when they are written to the &quot;encodings.dir&quot; 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.
<DT id="10"><B>-r</B>
<DD>
Keep non-absolute encoding directories in their relative form when
writing the &quot;encodings.dir&quot; 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="11"><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="12"><B>-u, -U</B>
<DD>
disable (<I>-u</I>) or enable (<I>-U</I>) indexing of ISO 10646:1 font
encodings (default: enabled).
<DT id="13"><B>-v</B>
<DD>
print program version and exit.
<DT id="14"><B>--</B>
<DD>
end of options.
</DL>
<A NAME="lbAF">&nbsp;</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+mkfontdir">mkfontdir</A>(1), <A HREF="/cgi-bin/man/man2html?1+ttmkfdir">ttmkfdir</A>(1), <A HREF="/cgi-bin/man/man2html?1+xfs">xfs</A>(1), <A HREF="/cgi-bin/man/man2html?1+xset">xset</A>(1)
<A NAME="lbAG">&nbsp;</A>
<H2>NOTES</H2>
The format of the
<B>fonts.scale</B>,
<B>fonts.dir</B>
and
<B>encodings.dir</B>
files is documented in the <A HREF="/cgi-bin/man/man2html?1+mkfontdir">mkfontdir</A>(1) manual page.
<P>
<B>Mkfontscale</B>
will overwrite any
<B>fonts.scale</B>
file even if it has been hand-edited.
<P>
<B>mkfontscale -b -s -l</B>
is equivalent to
<B>mkfontdir</B>.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
The version of
<B>mkfontscale</B>
included in this X.Org Foundation release was originally written by
Juliusz Chroboczek &lt;<A HREF="mailto:jch@freedesktop.org">jch@freedesktop.org</A>&gt; for the XFree86 project. The
functionality of this program was inspired by the
<B>ttmkfdir</B>
utility by Joerg Pommnitz.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="19"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="20"><A HREF="#lbAG">NOTES</A><DD>
<DT id="21"><A HREF="#lbAH">AUTHOR</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>