summaryrefslogtreecommitdiff
path: root/xfontsel.man
diff options
context:
space:
mode:
authorGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:56 -0500
committerGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:56 -0500
commit19bcefb4c89e02833cb7fcffeb7fd3f7224db1c4 (patch)
tree51733945fc6d9304717246ffdd470c161c9a6779 /xfontsel.man
parentf68420e9698d9a3b3e18cbefb96a3ccf9d555c65 (diff)
config: move man pages into their own directory
Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Diffstat (limited to 'xfontsel.man')
-rw-r--r--xfontsel.man227
1 files changed, 0 insertions, 227 deletions
diff --git a/xfontsel.man b/xfontsel.man
deleted file mode 100644
index 00c108d..0000000
--- a/xfontsel.man
+++ /dev/null
@@ -1,227 +0,0 @@
-.\" Copyright (c) 1994 X Consortium
-.\"
-.\" Permission is hereby granted, free of charge, to any person obtaining
-.\" a copy of this software and associated documentation files (the
-.\" "Software"), to deal in the Software without restriction, including
-.\" without limitation the rights to use, copy, modify, merge, publish,
-.\" distribute, sublicense, and/or sell copies of the Software, and to
-.\" permit persons to whom the Software is furnished to do so, subject to
-.\" the following conditions:
-.\"
-.\" 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 X CONSORTIUM 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 X Consortium 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 X Consortium.
-.\"
-.de EX \"Begin example
-.ne 5
-.if n .sp 1
-.if t .sp .5
-.nf
-.in +.5i
-..
-.de EE
-.fi
-.in -.5i
-.if n .sp 1
-.if t .sp .5
-..
-.TH XFONTSEL 1 __xorgversion__
-.SH NAME
-xfontsel \- point and click selection of X11 font names
-.SH SYNTAX
-.PP
-\fBxfontsel\fP [-\fItoolkitoption\fP ...]
-[\fB-pattern \fIfontname\fP]
-[\fB-print\fP]
-[\fB-sample \fItext\fP]
-[\fB-sample16 \fItext16\fP]
-[\fB-sampleUCS \fItextUCS\fP]
-[\fB-scaled\fP]
-.PP
-.SH DESCRIPTION
-.PP
-The \fIxfontsel\fP application provides a simple way to display
-the fonts known to your X server, examine samples of each, and
-retrieve the X Logical Font Description ("XLFD") full name for a font.
-.PP
-If \fB-pattern\fP is not specified, all fonts with XLFD 14-part
-names will be selectable. To work with only a subset of the
-fonts, specify \fB-pattern\fP followed by a partially or fully
-qualified font name; e.g., ``-pattern *medium*'' will
-select that subset of fonts which contain the string ``medium''
-somewhere in their font name. Be careful about escaping
-wildcard characters in your shell.
-.PP
-If \fB-print\fP is specified on the command line the selected
-font specifier will be written to standard output when the \fIquit\fP
-button is activated. Regardless of whether or not \fB-print\fP was
-specified, the font specifier may be made the PRIMARY (text)
-selection by activating the \fIselect\fP button.
-.PP
-The \fB-sample\fP option specifies the sample text to be used to
-display the selected font if the font is linearly indexed,
-overriding the default.
-.PP
-The \fB-sample16\fP option specifies the sample text to be used to
-display the selected font if the font is matrix encoded,
-overriding the default.
-.PP
-The \fB-sampleUCS\fP option specifies the sample text encoded in the UTF-8
-form to be used to display the selected font if the font has a
-CHARSET_REGISTRY of ISO10646, overriding the default.
-.PP
-The \fB-scaled\fP option enables the ability to select scaled fonts
-at arbitrary pixel or point sizes.
-.PP
-.SH INTERACTIONS
-.PP
-Clicking any pointer button in one of the XLFD field names will pop up
-a menu of the currently-known possibilities for that field. If
-previous choices of other fields were made, only values
-for fonts which matched the previously selected fields will be
-selectable; to make other values selectable, you must deselect
-some other field(s) by choosing the ``*'' entry in that field.
-Unselectable values may be omitted from the menu entirely as
-a configuration option; see the \fBShowUnselectable\fP resource, below.
-Whenever any change is made to a field value, \fIxfontsel\fP will
-assert ownership of the PRIMARY_FONT selection. Other applications
-(see, e.g., \fIxterm\fP) may then retrieve the selected font specification.
-.PP
-Scalable fonts come back from the server with zero for the pixel size,
-point size, and average width fields. Selecting a font name with a
-zero in these positions results in an implementation-dependent size.
-Any pixel or point size can be selected to scale the font to a particular
-size. Any average width can be selected to anamorphically scale the font
-(although you may find this challenging given the size of the average
-width menu).
-.PP
-Clicking the left pointer button in the \fIselect\fP widget will
-cause the currently selected font name to become the PRIMARY text
-selection as well as the PRIMARY_FONT selection.
-This then allows you to paste the string into other
-applications. The \fBselect\fP button remains
-highlighted to remind you of this fact, and de-highlights when
-some other application takes the PRIMARY selection away. The
-\fIselect\fP widget is a toggle; pressing it when it is highlighted
-will cause \fIxfontsel\fP to release the selection ownership and
-de-highlight the widget. Activating the \fIselect\fP widget twice
-is the only way to cause \fIxfontsel\fP to release the
-PRIMARY_FONT selection.
-.PP
-.SH RESOURCES
-.PP
-The application class is \fBXFontSel\fP. Most of the user-interface
-is configured in the app-defaults file; if this file is missing
-a warning message will be printed to standard output and the
-resulting window will be nearly incomprehensible.
-.PP
-Most of the significant parts of the widget hierarchy are documented
-in
-.IR __apploaddir__/XFontSel ,
-.PP
-Application specific resources:
-.PP
-.TP 8
-.B "cursor (\fPclass\fB Cursor)"
-Specifies the cursor for the application window.
-.TP 8
-.B "pattern (\fPclass\fB Pattern)"
-Specifies the font name pattern for selecting a subset of
-available fonts. Equivalent to the \fB-pattern\fP option.
-Most useful patterns will contain at least one field
-delimiter; e.g. ``*-m-*'' for monospaced fonts.
-.TP 8
-.B "pixelSizeList (\fPclass\fB PixelSizeList)"
-Specifies a list of pixel sizes to add to the pixel size menu,
-so that scalable fonts can be selected at those pixel sizes.
-The default pixelSizeList contains 7, 30, 40, 50, and 60.
-.TP 8
-.B "pointSizeList (\fPclass\fB PointSizeList)"
-Specifies a list of point sizes (in units of tenths of points) to add to
-the point size menu, so that scalable fonts can be selected at those
-point sizes. The default pointSizeList contains 250, 300, 350, and 400.
-.TP 8
-.B "printOnQuit (\fPclass\fB PrintOnQuit)"
-If \fITrue\fP the currently selected font name is printed
-to standard output when the quit button is activated.
-Equivalent to the \fB-print\fP option.
-.TP 8
-.B "sampleText (\fPclass\fB Text)"
-The sample 1-byte text to use for linearly indexed fonts.
-Each glyph index is a single byte, with newline separating lines.
-.TP 8
-.B "sampleText16 (\fPclass\fB Text16)"
-The sample 2-byte text to use for matrix-encoded fonts.
-Each glyph index is two bytes, with a 1-byte newline separating lines.
-.TP 8
-.B "scaledFonts (\fPclass\fB ScaledFonts)"
-If \fITrue\fP then selection of arbitrary pixel and point sizes for
-scalable fonts is enabled.
-.PP
-Widget specific resources:
-.PP
-.TP 8
-.B "showUnselectable (\fPclass\fB ShowUnselectable)"
-Specifies, for each field menu, whether or not to show values that
-are not currently selectable, based upon previous field selections.
-If shown, the unselectable values are clearly identified as such
-and do not highlight when the pointer is moved down the menu.
-The full name of this resource is \fBfieldN.menu.options.showUnselectable\fP,
-class \fBMenuButton.SimpleMenu.Options.ShowUnselectable\fP;
-where N is replaced with the field
-number (starting with the left-most field numbered 0).
-The default is True for all but field 11 (average width of characters
-in font) and False for field 11. If you never want to see
-unselectable entries, '*menu.options.showUnselectable:False' is
-a reasonable thing to specify in a resource file.
-.PP
-.SH FILES
-.PP
- $XFILESEARCHPATH/XFontSel
-.PP
-.SH SEE ALSO
-xrdb(__appmansuffix__), xfd(__appmansuffix__)
-.PP
-.SH BUGS
-.PP
-Sufficiently ambiguous patterns can be misinterpreted and lead to an
-initial selection string which may not correspond to what the user intended
-and which may cause the initial sample text output to fail to match
-the proffered string. Selecting any new field value will correct the
-sample output, though possibly resulting in no matching font.
-.PP
-Should be able to return a FONT for the PRIMARY selection, not
-just a STRING.
-.PP
-Any change in a field value will cause \fIxfontsel\fP to assert
-ownership of the PRIMARY_FONT selection. Perhaps this should
-be parameterized.
-.PP
-When running on a slow machine, it is possible for the user to
-request a field menu before the font names have been completely
-parsed. An error message indicating a missing menu is printed
-to stderr but otherwise nothing bad (or good) happens.
-.PP
-The average-width menu is too large to be useful.
-.SH COPYRIGHT
-Copyright 1989, 1991, X Consortium
-.PP
-See \fIX(__miscmansuffix__)\fP for a full statement of rights and permissions.
-.SH AUTHOR
-.PP
-Ralph R. Swick, Digital Equipment Corporation/MIT Project Athena
-.PP
-Mark Leisher <mleisher@crl.nmsu.edu> added the support for the UTF-8 sample
-text.