diff options
| -rw-r--r-- | xlsfonts.c | 4 | ||||
| -rw-r--r-- | xlsfonts.man | 255 | ||||
| -rw-r--r-- | xlsfonts.sgml | 473 |
3 files changed, 635 insertions, 97 deletions
@@ -93,9 +93,9 @@ void usage(void) fprintf (stderr, " -1 force single column\n"); fprintf (stderr, " -u keep output unsorted\n"); #ifdef BUILD_PRINTSUPPORT - fprintf (stderr, " -b list printer builtin fonts (default)\n"); + fprintf (stderr, " -b list printer builtin fonts\n"); fprintf (stderr, " -B do not list printer builtin fonts\n"); - fprintf (stderr, " -g list glyph fonts (default)\n"); + fprintf (stderr, " -g list glyph fonts\n"); fprintf (stderr, " -G do not list glyph fonts\n"); fprintf (stderr, " -x mode enable listfont mode\n"); fprintf (stderr, " -X mode disable listfont mode\n"); diff --git a/xlsfonts.man b/xlsfonts.man index c9f4a8f..bf5a35f 100644 --- a/xlsfonts.man +++ b/xlsfonts.man @@ -1,105 +1,170 @@ -.\" $Xorg: xlsfonts.man,v 1.4 2001/02/09 02:05:55 xorgcvs Exp $ -.\" Copyright 1988, 1998 The Open Group -.\" -.\" Permission to use, copy, modify, distribute, and sell this software and its -.\" documentation for any purpose is hereby granted without fee, provided that -.\" the above copyright notice appear in all copies and that both that -.\" copyright notice and this permission notice appear in supporting -.\" documentation. -.\" -.\" The above copyright notice and this permission notice shall be included -.\" in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of The Open Group shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from The Open Group. -.\" -.\" $XFree86: xc/programs/xlsfonts/xlsfonts.man,v 1.7 2001/01/27 18:21:18 dawes Exp $ -.\" -.TH XLSFONTS 1 __xorgversion__ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng <steve@ggi-project.org>. +.TH "XLSFONTS" "__appmansuffix__" "07 October 2004" "" "" .SH NAME xlsfonts \- server font list displayer for X .SH SYNOPSIS -.B xlsfonts -[\-options ...] [\-fn pattern] -.SH DESCRIPTION -.I Xlsfonts -lists the fonts that match the given \fIpattern\fP. -The wildcard character "*" may be used to match any sequence of -characters (including none), and "?" to match any single character. + +\fBxlsfonts\fR [ \fB-display \fIhost:dpy\fB\fR] [ \fB-l\fR] [ \fB-ll\fR] [ \fB-lll\fR] [ \fB-m\fR] [ \fB-C\fR] [ \fB-1\fR] [ \fB-w \fIwidth\fB\fR] [ \fB-n \fIcolumns\fB\fR] [ \fB-u\fR] [ \fB-o\fR] [ \fB-fn \fIpattern\fB\fR] + + +\fBxlsfonts\fR \fB-printer \fIprintername\fB\fR [ \fB-l\fR] [ \fB-ll\fR] [ \fB-lll\fR] [ \fB-m\fR] [ \fB-C\fR] [ \fB-1\fR] [ \fB-w \fIwidth\fB\fR] [ \fB-n \fIcolumns\fB\fR] [ \fB-u\fR] [ \fB-o\fR] [ \fB-b\fR] [ \fB-B\fR] [ \fB-g\fR] [ \fB-G\fR] [ \fB-x \fImode\fB\fR] [ \fB-X \fImode\fB\fR] [ \fB-fn \fIpattern\fB\fR] + +.SH "DESCRIPTION" +.PP +\fBxlsfonts\fR 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. .PP -The "*" and "?" characters must be quoted to prevent them from -being expanded by the shell. +The "*" and "?" characters must be quoted to prevent them from being expanded by the shell. .SH "OPTIONS" -.PP -.TP 8 -.B \-display \fIhost\fP:\fIdpy\fP +.TP +\fB-display \fIhost:dpy\fB \fR This option specifies the X server to contact. -.PP -.TP 8 -.B \-l -Lists some attributes of the font on one line in addition to its name. -.TP 8 -.B \-ll -Lists font properties in addition to \fB\-l\fP output. -.TP 8 -.B \-lll -Lists character metrics in addition to \fB\-ll\fP output. -.TP 8 -.B \-m -This option indicates that long listings should also print the minimum and -maximum bounds of each font. -.TP 8 -.B \-C -This option indicates that listings should use multiple columns. This is the -same as \fB\-n 0\fP. -.TP 8 -.B \-1 -This option indicates that listings should use a single column. This is the -same as \fB\-n 1\fP. -.TP 8 -.B \-w \fIwidth\fP -This option specifies the width in characters that should be used in -figuring out how many columns to print. The default is 79. -.TP 8 -.B \-n \fIcolumns\fP -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 \fB\-w \fIwidth\fR. -.TP 8 -.B \-u +.TP +\fB-printer \fIprintername\fB \fR +This option specifies the Xprint printer to contact. +.TP +\fB-d \fIhost:dpy\fB \fR +Same as \fB-display \fIhost:dpy\fB\fR. +.TP +\fB-p \fIprintername\fB \fR +Same as \fB-printer \fIprintername\fB\fR. +.TP +\fB-l \fR +Lists some attributes of the font on one line in addition +to its name. +.TP +\fB-ll \fR +Lists font properties in addition to \fB-l\fR output. +.TP +\fB-lll \fR +Lists character metrics in addition to \fB-ll\fR output. +.TP +\fB-m \fR +This option indicates that long listings should also print +the minimum and maximum bounds of each font. +.TP +\fB-C \fR +This option indicates that listings should use multiple columns. +This is the same as \fB-n 0\fR. +.TP +\fB-1 \fR +This option indicates that listings should use a single column. +This is the same as \fB-n 1\fR. +.TP +\fB-w \fIwidth\fB \fR +This option specifies the width in characters that should be +used in figuring out how many columns to print. +The default is 79. +.TP +\fB-n \fIcolumns\fB \fR +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 \fB-w\fR width. +.TP +\fB-u \fR This option indicates that the output should be left unsorted. -.TP 8 -.B \-o -This option indicates that \fIxlsfonts\fP should do an \fBOpenFont\fP (and -\fBQueryFont\fP, if appropriate) rather than a \fBListFonts\fP. This is -useful if \fBListFonts\fP or \fBListFontsWithInfo\fP fail to list a known -font (as is the case with some scaled font systems). -.TP 8 -.B \-fn \fIpattern\fP +.TP +\fB-o \fR +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). +.TP +\fB-b \fR +List printer builtin fonts. +This is the same as \fB-x xp-list-internal-printer-fonts\fR. + +(printer mode only) +.TP +\fB-B \fR +Do not list printer builtin fonts. +This is the same as \fB-X xp-list-internal-printer-fonts\fR. + +(printer mode only) +.TP +\fB-g \fR +List glyph fonts. +This is the same as \fB-x xp-list-glyph-fonts\fR. + +(printer mode only) +.TP +\fB-G \fR +Do not list glyph fonts. +This is the same as \fB-X xp-list-glyph-fonts\fR. + +(printer mode only) +.TP +\fB-x \fImode\fB \fR +Enable listfont mode \fImode\fR. + +Supported modes are: +.RS +.TP +\fBxp-listinternal-printer-fonts\fR +If xp-listinternal-printer-fonts was set +(via option \fB-b\fR or +\fB-x xp-listinternal-printer-fonts\fR \fBxlsfonts\fR +will include all of the fonts defined as internal printer fonts. +.TP +\fBxp-list-glyph-fonts\fR +If xp-list-glyph-fonts was set (via option \fB-g\fR or +\fB-x xp-list-glyph-fonts\fR) \fBxlsfonts\fR will +include all of the fonts available to the server which have +glyphs associated with them. +.RE + +The default value is implicitly determined by the ddx driver to be the +all of the listfonts modes specified in the xp-listfonts-modes-supported +printer attribute. + +The value of xp-listfonts-modes-supported and +xp-listfonts-modes (the defaults) can be looked-up via +\fBxplsprinters\fR(__appmansuffix__). + +(printer mode only) +.TP +\fB-X \fImode\fB \fR +Disable listfont mode \fImode\fR. +See option \fB-x\fR for a list of valid +\fImode\fR values. + +(printer mode only) +.TP +\fB-fn \fIpattern\fB \fR This option specifies the font name pattern to match. -.PP .SH "SEE ALSO" -X(__miscmansuffix__), Xserver(1), xset(1), xfd(1), -.I "X Logical Font Description Conventions" -.SH ENVIRONMENT -.TP 8 -.B DISPLAY -to get the default host and display to use. -.SH BUGS -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. -.SH AUTHOR -Mark Lillibridge, MIT Project Athena; Jim Fulton, MIT X Consortium; -Phil Karlton, SGI +.PP +\fBX\fR(__miscmansuffix__), \fBXprint\fR(__miscmansuffix__), \fBXserver\fR(__appmansuffix__), \fBxset\fR(__appmansuffix__), \fBxfd\fR(__appmansuffix__), \fBxplsprinters\fR(__appmansuffix__), X Logical Font Description Conventions +.SH "ENVIRONMENT" +.TP +\fBDISPLAY \fR +\fBDISPLAY\fR must be set to get the default host and display to use. +.TP +\fBXPSERVERLIST \fR +\fBXPSERVERLIST\fR must be set for the \fB-printer\fR option +identifying the available Xprint servers. +See \fBXprint\fR(__miscmansuffix__) +for more details. +.SH "BUGS" +.PP +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. +.SH "AUTHOR" +.PP + +MarkLillibridgeMIT Project Athena + +JimFultonMIT X Consortium + +PhilKarltonSGI + +RolandMainzUniversity Giessen diff --git a/xlsfonts.sgml b/xlsfonts.sgml new file mode 100644 index 0000000..34b4dba --- /dev/null +++ b/xlsfonts.sgml @@ -0,0 +1,473 @@ +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.2//EN" '/usr/share/sgml/docbook_4.2/docbook.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>-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>-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> + + |