492 lines
15 KiB
Plaintext
492 lines
15 KiB
Plaintext
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.2//EN" 'http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd'>
|
|
|
|
<!-- Process this file with DocBook tools to generate the output format
|
|
(such as manual pages or HTML documents).
|
|
|
|
Note that strings like __appmansuffix__, __filemansuffix__, __libmansuffix__,
|
|
__miscmansuffix__ etc. have to be replaced first (in theory that's the
|
|
job of ENTITIES but some XML tools are highly allergic to such stuff... ;-().
|
|
A quick way to do that is to filter this document via
|
|
/usr/bin/sed "s/__appmansuffix__/${MANSUFFIX}/g;s/__filemansuffix__/${FILEMANSUFFIX}/g;s/__libmansuffix__/${LIBMANSUFFIX}/g;s/__miscmansuffix__/${MISCMANSUFFIX}/g"
|
|
assuming that env vars like MANSUFFIX etc. have been set to the matching
|
|
manual volume numbers.
|
|
-->
|
|
|
|
<refentry>
|
|
<refmeta>
|
|
<refentrytitle>xlsfonts</refentrytitle>
|
|
<manvolnum>__appmansuffix__</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>xlsfonts</refname>
|
|
<refpurpose>server font list displayer for X</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<!-- video mode -->
|
|
<cmdsynopsis>
|
|
<command>xlsfonts</command>
|
|
|
|
<arg><option>-display <replaceable>host:dpy</replaceable></option></arg>
|
|
|
|
<arg><option>-l</option></arg>
|
|
|
|
<arg><option>-ll</option></arg>
|
|
|
|
<arg><option>-lll</option></arg>
|
|
|
|
<arg><option>-m</option></arg>
|
|
|
|
<arg><option>-C</option></arg>
|
|
|
|
<arg><option>-1</option></arg>
|
|
|
|
<arg><option>-w <replaceable>width</replaceable></option></arg>
|
|
|
|
<arg><option>-n <replaceable>columns</replaceable></option></arg>
|
|
|
|
<arg><option>-u</option></arg>
|
|
|
|
<arg><option>-o</option></arg>
|
|
|
|
<arg><option>-fn <replaceable>pattern</replaceable></option></arg>
|
|
</cmdsynopsis>
|
|
|
|
<!-- printer mode -->
|
|
<cmdsynopsis>
|
|
<command>xlsfonts</command>
|
|
|
|
<arg choice="plain"><option>-printer <replaceable>printername</replaceable></option></arg>
|
|
|
|
<arg><option>-l</option></arg>
|
|
|
|
<arg><option>-ll</option></arg>
|
|
|
|
<arg><option>-lll</option></arg>
|
|
|
|
<arg><option>-m</option></arg>
|
|
|
|
<arg><option>-C</option></arg>
|
|
|
|
<arg><option>-1</option></arg>
|
|
|
|
<arg><option>-w <replaceable>width</replaceable></option></arg>
|
|
|
|
<arg><option>-n <replaceable>columns</replaceable></option></arg>
|
|
|
|
<arg><option>-u</option></arg>
|
|
|
|
<arg><option>-o</option></arg>
|
|
|
|
<arg><option>-r <replaceable>resolution</replaceable></option></arg>
|
|
|
|
<arg><option>-b</option></arg>
|
|
|
|
<arg><option>-B</option></arg>
|
|
|
|
<arg><option>-g</option></arg>
|
|
|
|
<arg><option>-G</option></arg>
|
|
|
|
<arg><option>-x <replaceable>mode</replaceable></option></arg>
|
|
|
|
<arg><option>-X <replaceable>mode</replaceable></option></arg>
|
|
|
|
<arg><option>-fn <replaceable>pattern</replaceable></option></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
|
|
<para>
|
|
<command>xlsfonts</command> lists the fonts that match the given pattern.
|
|
The wildcard character "*" may be used to match any sequence of characters
|
|
(including none), and "?" to match any single character.
|
|
If no pattern is given, "*" is assumed.
|
|
</para>
|
|
<para>
|
|
The "*" and "?" characters must be quoted to prevent them from being expanded by the shell.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><option>-display <replaceable>host:dpy</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option specifies the X server to contact.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-printer <replaceable>printername</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option specifies the Xprint printer to contact.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-d <replaceable>host:dpy</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Same as <option>-display <replaceable>host:dpy</replaceable></option>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-p <replaceable>printername</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Same as <option>-printer <replaceable>printername</replaceable></option>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-l</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Lists some attributes of the font on one line in addition
|
|
to its name.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-ll</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Lists font properties in addition to <option>-l</option> output.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-lll</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Lists character metrics in addition to <option>-ll</option> output.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-m</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option indicates that long listings should also print
|
|
the minimum and maximum bounds of each font.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-C</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option indicates that listings should use multiple columns.
|
|
This is the same as <option>-n 0</option>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-1</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option indicates that listings should use a single column.
|
|
This is the same as <option>-n 1</option>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-w <replaceable>width</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option specifies the width in characters that should be
|
|
used in figuring out how many columns to print.
|
|
The default is 79.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-n <replaceable>columns</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option specifies the number of columns to use in
|
|
displaying the output. By default, it will attempt to
|
|
fit as many columns of font names into the number of
|
|
character specified by <option>-w</option> width.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-u</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option indicates that the output should be left unsorted.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-o</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option indicates that xlsfonts should do an OpenFont
|
|
(and QueryFont, if appropriate) rather than a ListFonts.
|
|
This is useful if ListFonts or ListFontsWithInfo fail to
|
|
list a known font (as is the case with some scaled font
|
|
systems).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-r <replaceable>resolutionname</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Set print resolution name (usually values like <literal>300dpi</literal>
|
|
or <literal>300x600</literal>, see output of <command>xplsprinters</command>).
|
|
This may alter the output of <command>xlsfonts</command> if there are printer
|
|
fonts which get enabled/disabled on per-resolution basis by the DDX.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-b</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
List printer builtin fonts.
|
|
This is the same as <option>-x xp-list-internal-printer-fonts</option>.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-B</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Do not list printer builtin fonts.
|
|
This is the same as <option>-X xp-list-internal-printer-fonts</option>.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-g</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
List glyph fonts.
|
|
This is the same as <option>-x xp-list-glyph-fonts</option>.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-G</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Do not list glyph fonts.
|
|
This is the same as <option>-X xp-list-glyph-fonts</option>.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-x <replaceable>mode</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Enable listfont mode <replaceable>mode</replaceable>.
|
|
</para>
|
|
<para>
|
|
Supported modes are:
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>xp-listinternal-printer-fonts</term>
|
|
<listitem>
|
|
<para>
|
|
If <literal>xp-listinternal-printer-fonts</literal> was set
|
|
(via option <option>-b</option> or
|
|
<option>-x xp-listinternal-printer-fonts</option> <command>xlsfonts</command>
|
|
will include all of the fonts defined as internal printer fonts.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>xp-list-glyph-fonts</term>
|
|
<listitem>
|
|
<para>
|
|
If <literal>xp-list-glyph-fonts</literal> was set (via option <option>-g</option> or
|
|
<option>-x xp-list-glyph-fonts</option>) <command>xlsfonts</command> will
|
|
include all of the fonts available to the server which have
|
|
glyphs associated with them.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
<para>
|
|
The default value is implicitly determined by the ddx driver to be the
|
|
all of the listfonts modes specified in the <literal>xp-listfonts-modes-supported</literal>
|
|
printer attribute.
|
|
</para>
|
|
|
|
<para>
|
|
The value of <literal>xp-listfonts-modes-supported</literal> and
|
|
<literal>xp-listfonts-modes</literal> (the defaults) can be looked-up via
|
|
<citerefentry><refentrytitle>xplsprinters</refentrytitle><manvolnum>__appmansuffix__</manvolnum></citerefentry>.
|
|
</para>
|
|
</para>
|
|
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-X <replaceable>mode</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Disable listfont mode <replaceable>mode</replaceable>.
|
|
See option <option>-x</option> for a list of valid
|
|
<replaceable>mode</replaceable> values.
|
|
</para>
|
|
<para>
|
|
(printer mode only)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-fn <replaceable>pattern</replaceable></option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
This option specifies the font name pattern to match.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>SEE ALSO</title>
|
|
<para>
|
|
<simplelist type="inline">
|
|
<member><citerefentry><refentrytitle>X</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>Xserver</refentrytitle><manvolnum>__appmansuffix__</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>xset</refentrytitle><manvolnum>__appmansuffix__</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>xfd</refentrytitle><manvolnum>__appmansuffix__</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>xplsprinters</refentrytitle><manvolnum>__appmansuffix__</manvolnum></citerefentry></member>
|
|
<member>X Logical Font Description Conventions</member>
|
|
</simplelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>ENVIRONMENT</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><envar>DISPLAY</envar>
|
|
</term>
|
|
<listitem>
|
|
<para><envar>DISPLAY</envar> must be set to get the default host and display to use.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><envar>XPSERVERLIST</envar>
|
|
</term>
|
|
<listitem>
|
|
<para><envar>XPSERVERLIST</envar> must be set for the <option>-printer</option> option
|
|
identifying the available Xprint servers.
|
|
See <citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry>
|
|
for more details.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>BUGS</title>
|
|
|
|
<para>
|
|
Doing ``xlsfonts -l'' can tie up your server for a very long time.
|
|
This is really a bug with single-threaded
|
|
non-preemptable servers, not with this program.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>AUTHOR</title>
|
|
|
|
<para>
|
|
<simplelist>
|
|
<member><othercredit><firstname>Mark</firstname> <surname>Lillibridge</surname> <affiliation><orgname>MIT Project Athena</orgname></affiliation></othercredit></member>
|
|
<member><othercredit><firstname>Jim</firstname> <surname>Fulton</surname> <affiliation><orgname>MIT X Consortium</orgname></affiliation></othercredit></member>
|
|
<member><othercredit><firstname>Phil</firstname> <surname>Karlton</surname> <affiliation><orgname>SGI</orgname></affiliation></othercredit></member>
|
|
<member><othercredit><firstname>Roland</firstname> <surname>Mainz</surname> <affiliation><orgname>University Giessen</orgname></affiliation></othercredit></member>
|
|
</simplelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
|
|
|