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

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

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/man1/x11fonts.1	Fri May 20 15:19:45 2011 +0100
@@ -0,0 +1,123 @@
+.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.
+