annotate man/man1/x11fonts.1 @ 0:5242703e91d3 tip

Initial checkin for AIM92 aimR8.2 (last updated May 1997).

.TH X11FONTS 1 "1 September 1993"

.SH NAME
x11fonts \- search and display fonts.

.SH SYNTAX 
x11fonts [options] [name_patterns]

.SH DESCRIPTION

Display the font for each font name found in the current font search path
which matches a given name_pattern.
Each name_pattern may contain wild-card (*) characters, (but
names with wild-cards should be quoted to escape the shell).
The default name_pattern is "*", meaning all fontnames.

Each font is displayed in an X window in the form:

.nf
    [m/n]   <full fontname>

     <alphabet>
.fi

showing the m'th font out of n fonts which match the current name_pattern.
The pointer is used to click through the fonts which match each given name_pattern
as follows:

.nf
    left button
.fi

Clear the last font displayed and
display the font for the next fontname in its place.

.nf
    centre button
.fi

Display the font for the next fontname beneath the last font
displayed. This is used to store particular fonts for comparison with others.
When successive fonts have filled the window
it is cleared and the last font is re-displayed at the top of
the window.

.nf
    right button
.fi

Begin the next name_pattern.
The program quits when there are no more name patterns.

.SH OPTIONS

.nf
    -n
.fi

Print on the stdout a count of the fonts found in the search
path which match each name_pattern.

.nf
    -l
.fi

Print on the stdout a list of the font names found in the
search path which match each name_pattern.

.nf
    -P
.fi

Print on the stdout the current font search path
(see: XGetFontPath XSetFontPath).


.SH EXAMPLES

1. Print a count of how many fonts match the name_pattern "-adobe*" and then
list their names on the stdout.

.nf
	x11fonts -n "-adobe*"
	x11fonts -l "-adobe*"
.fi

2. Compare fonts "fixed" and "variable" (use button sequence: right, centre).

.nf
	x11fonts  fixed variable
.fi

3. Display the alphabet of a particular font name "7x14", then of all fonts
ending with the pattern "x16", and then of all bold fonts.

.nf
	x11fonts  7x14  "*x16" "*bold*"
.fi

.SH COPYRIGHT
.LP
Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
.LP
Permission to use, copy, modify, and distribute this software without fee 
is hereby granted for research purposes, provided that this copyright 
notice appears in all copies and in all supporting documentation, and that 
the software is not redistributed for any fee (except for a nominal 
shipping charge). Anyone wanting to incorporate all or part of this 
software in a commercial product must obtain a license from the Medical 
Research Council.
.LP
The MRC makes no representations about the suitability of this 
software for any purpose.  It is provided "as is" without express or 
implied warranty.
.LP
THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL 
THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES 
OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
SOFTWARE.