xc/programs/xlsfonts/Imakefile

xc/programs/xlsfonts/dsimple.c
xc/programs/xlsfonts/dsimple.h
//freedesktop.org/bugzilla/show_bug.cgi?id=1518) attachment #1022
    (https://bugs.freedesktop.org/attachment.cgi?id=1022): Add filter
    support to "xlsfonts" that it can filter builtin-, glyph- and/or other
    kinds of printer fonts (controlled by the xp-listfonts-modes attribute
    as described in the CDE DtPrint and Xprint specifications).

1 files changed, 92 insertions, 162 deletions

diff --git a/xlsfonts.man b/xlsfonts.man
index 325ce06..c9f4a8f 100644
--- a/xlsfonts.man
+++ b/xlsfonts.man
@@ -1,175 +1,105 @@
-.\" -*- coding: us-ascii -*-
-.TH xlsfonts __appmansuffix__ "8 October 2004"  
+.\" $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__
 .SH NAME
 xlsfonts \- server font list displayer for X
 .SH SYNOPSIS
-.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
-.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
+.B xlsfonts
+[\-options ...] [\-fn pattern]
 .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.
+.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.
 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 
+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
 This option specifies the X server to contact.
-.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 
+.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
 This option indicates that the output should be left unsorted.
-.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 
-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 
-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 \fBxp\-listfonts\-modes\-supported\fR
-printer attribute.
-
-
-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 
-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 
+.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
 This option specifies the font name pattern to match.
+.PP
 .SH "SEE ALSO"
-\fBX\fR(__miscmansuffix__), \fBXprint\fR(__miscmansuffix__), \fBXserver\fR(__appmansuffix__), \fBxset\fR(__appmansuffix__), \fBxfd\fR(__appmansuffix__), \fBxplsprinters\fR(__appmansuffix__), X Logical Font Description Conventions
+X(__miscmansuffix__), Xserver(1), xset(1), xfd(1),
+.I "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.
+.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.
+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
-.PP
-Jim Fulton
-.PP
-Phil Karlton
-.PP
-Roland Mainz
-
+Mark Lillibridge, MIT Project Athena; Jim Fulton, MIT X Consortium;
+Phil Karlton, SGI