Fix for https://freedesktop.org/bugzilla/show_bug.cgi?id=1551 - Convert

    "xlsfonts" manual page to DocBook format (and document the new
    functionality introduced with bug #1518).

3 files changed, 635 insertions, 97 deletions

diff --git a/xlsfonts.c b/xlsfonts.c
index f3e469c..9718c93 100644
--- a/xlsfonts.c
+++ b/xlsfonts.c
@@ -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>
+
+