summaryrefslogtreecommitdiff
path: root/xlsfonts.man
diff options
context:
space:
mode:
authorRoland Mainz <roland.mainz@nrubsig.org>2004-10-08 02:39:41 +0000
committerRoland Mainz <roland.mainz@nrubsig.org>2004-10-08 02:39:41 +0000
commitae8577dff6379de49740660194e5e8d0b33bca58 (patch)
treeea2372b45431af32f94bf08516c1d6298615fd24 /xlsfonts.man
parent22ac7ab05c6917dbd36be4ea0429cef2a6e3fa0e (diff)
DocBook SGML+XML manual pages and docmentation and the in-tree copies of the generated files (*.man, *.html) to get them properly working with newer versions of the tools within the Xorg tree.
Diffstat (limited to 'xlsfonts.man')
-rw-r--r--xlsfonts.man205
1 files changed, 105 insertions, 100 deletions
diff --git a/xlsfonts.man b/xlsfonts.man
index bf5a35f..325ce06 100644
--- a/xlsfonts.man
+++ b/xlsfonts.man
@@ -1,170 +1,175 @@
-.\" 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" "" ""
+.\" -*- coding: us-ascii -*-
+.TH xlsfonts __appmansuffix__ "8 October 2004"
.SH NAME
xlsfonts \- server font list displayer for X
.SH SYNOPSIS
-
-\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"
+.ad l
+\fBxlsfonts\fR \kx
+.if (\nxu > (\n(.lu / 2)) .nr x (\n(.lu / 5)
+'in \n(.iu+\nxu
+[\fB\-display \fBhost:dpy\fR\fR] [\fB\-l\fR] [\fB\-ll\fR] [\fB\-lll\fR] [\fB\-m\fR] [\fB\-C\fR] [\fB\-1\fR] [\fB\-w \fBwidth\fR\fR] [\fB\-n \fBcolumns\fR\fR] [\fB\-u\fR] [\fB\-o\fR] [\fB\-fn \fBpattern\fR\fR]
+'in \n(.iu-\nxu
+.ad b
.PP
-\fBxlsfonts\fR lists the fonts that match the given pattern.
+.ad l
+\fBxlsfonts\fR \kx
+.if (\nxu > (\n(.lu / 2)) .nr x (\n(.lu / 5)
+'in \n(.iu+\nxu
+\fB\-printer \fBprintername\fR\fR [\fB\-l\fR] [\fB\-ll\fR] [\fB\-lll\fR] [\fB\-m\fR] [\fB\-C\fR] [\fB\-1\fR] [\fB\-w \fBwidth\fR\fR] [\fB\-n \fBcolumns\fR\fR] [\fB\-u\fR] [\fB\-o\fR] [\fB\-b\fR] [\fB\-B\fR] [\fB\-g\fR] [\fB\-G\fR] [\fB\-x \fBmode\fR\fR] [\fB\-X \fBmode\fR\fR] [\fB\-fn \fBpattern\fR\fR]
+'in \n(.iu-\nxu
+.ad b
+.SH DESCRIPTION
+xlsfonts 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.
-.SH "OPTIONS"
-.TP
-\fB-display \fIhost:dpy\fB \fR
+.SH OPTIONS
+.TP
+\fB\-display \fIhost:dpy\fB\fR
This option specifies the X server to contact.
-.TP
-\fB-printer \fIprintername\fB \fR
+.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
+.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
+.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
+.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 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 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
+.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
+character specified by \fB\-w\fR width.
+.TP
+\fB\-u\fR
This option indicates that the output should be left unsorted.
-.TP
-\fB-o \fR
+.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
+.TP
+\fB\-b\fR
List printer builtin fonts.
-This is the same as \fB-x xp-list-internal-printer-fonts\fR.
+This is the same as \fB\-x xp\-list\-internal\-printer\-fonts\fR.
(printer mode only)
-.TP
-\fB-B \fR
+.TP
+\fB\-B\fR
Do not list printer builtin fonts.
-This is the same as \fB-X xp-list-internal-printer-fonts\fR.
+This is the same as \fB\-X xp\-list\-internal\-printer\-fonts\fR.
(printer mode only)
-.TP
-\fB-g \fR
+.TP
+\fB\-g\fR
List glyph fonts.
-This is the same as \fB-x xp-list-glyph-fonts\fR.
+This is the same as \fB\-x xp\-list\-glyph\-fonts\fR.
(printer mode only)
-.TP
-\fB-G \fR
+.TP
+\fB\-G\fR
Do not list glyph fonts.
-This is the same as \fB-X xp-list-glyph-fonts\fR.
+This is the same as \fB\-X xp\-list\-glyph\-fonts\fR.
(printer mode only)
-.TP
-\fB-x \fImode\fB \fR
+.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
+.RS
+.TP
+xp-listinternal-printer-fonts
+If \fBxp\-listinternal\-printer\-fonts\fR was set
+(via option \fB\-b\fR or
+\fB\-x xp\-listinternal\-printer\-fonts\fR xlsfonts
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
+.TP
+xp-list-glyph-fonts
+If \fBxp\-list\-glyph\-fonts\fR was set (via option \fB\-g\fR or
+\fB\-x xp\-list\-glyph\-fonts\fR) xlsfonts 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
+all of the listfonts modes specified in the \fBxp\-listfonts\-modes\-supported\fR
printer attribute.
-The value of xp-listfonts-modes-supported and
-xp-listfonts-modes (the defaults) can be looked-up via
+
+The value of \fBxp\-listfonts\-modes\-supported\fR and
+\fBxp\-listfonts\-modes\fR (the defaults) can be looked-up via
\fBxplsprinters\fR(__appmansuffix__).
+
(printer mode only)
-.TP
-\fB-X \fImode\fB \fR
+.TP
+\fB\-X \fImode\fB\fR
Disable listfont mode \fImode\fR.
-See option \fB-x\fR for a list of valid
+See option \fB\-x\fR for a list of valid
\fImode\fR values.
(printer mode only)
-.TP
-\fB-fn \fIpattern\fB \fR
+.TP
+\fB\-fn \fIpattern\fB\fR
This option specifies the font name pattern to match.
.SH "SEE ALSO"
-.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
+.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
+.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
+.SH BUGS
Doing ``xlsfonts -l'' can tie up your server for a very long time.
-This is really a bug with single-threaded
+This is really a bug with single-threaded
non-preemptable servers, not with this program.
-.SH "AUTHOR"
-.PP
-
-MarkLillibridgeMIT Project Athena
-
-JimFultonMIT X Consortium
+.SH AUTHOR
-PhilKarltonSGI
+Mark Lillibridge
+.PP
+Jim Fulton
+.PP
+Phil Karlton
+.PP
+Roland Mainz
-RolandMainzUniversity Giessen