1 XFONTSEL
Point & click interface for  selecting  X11  font names

SYNTAX
     xfontsel [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-pattern  _f_o_n_t_n_a_m_e]  [-print]
     [-sample _t_e_x_t]

2 DESCRIPTION
     The _x_f_o_n_t_s_e_l 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.

     If -pattern is not specified, all fonts  with  XLFD  14-part
     names will be selectable.  To work with only a subset of the
     fonts, specify -pattern 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.

     If -print is specified on the command line the selected font
     specifier  will  be written to standard output when the _q_u_i_t
     button is activated.  Regardless of whether  or  not  -print
     was  specified,  the  font specifier may be made the PRIMARY
     (text) selection by activating the _s_e_l_e_c_t button.

     The -sample option specifies the sample text to be  used  to
     display the selected font, overriding the default.

2 INTERACTIONS
     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
     ShowUnselectable resource, below.  Whenever  any  change  is
     made to a field value, _x_f_o_n_t_s_e_l will assert ownership of the
     PRIMARY_FONT  selection.   Other  applications  (see,  e.g.,
     _x_t_e_r_m) may then retrieve the selected font specification.

     Clicking the left pointer button in the _s_e_l_e_c_t  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 select button remains highlighted to remind you of  this
     fact,  and  de-highlights  when some other application takes
     the PRIMARY selection away.  The _s_e_l_e_c_t widget is a  toggle;
     pressing  it  when  it is highlighted will cause _x_f_o_n_t_s_e_l to
     release the selection ownership and de-highlight the widget.
     Activating  the _s_e_l_e_c_t widget twice is the only way to cause
     _x_f_o_n_t_s_e_l to release the PRIMARY_FONT selection.

2 RESOURCES
     The application  class  is  XFontSel.   Most  of  the  user-
     interface  is  configured  in the app-defaults file; if this
     file is missing a warning message will be printed  to  stan-
     dard   output  and  the  resulting  window  will  be  nearly
     incomprehensible.

     Most of the significant parts of the  widget  hierarchy  are
     documented    in    the    app-defaults    file    (normally
     /usr/lib/X11/app-defaults/XFontSel).

     Application specific resources:

     cursor (class Cursor)
             Specifies the cursor for the application window.

     pattern (class Pattern)
             Specifies the font name pattern for selecting a sub-
             set  of available fonts.  Equivalent to the -pattern
             option.  Most useful patterns will contain at  least
             one  field  delimiter; e.g. ``*-m-*'' for monospaced
             fonts.

     printOnQuit (class PrintOnQuit)
             If _T_r_u_e the currently selected font name is  printed
             to   standard   output   when  the  quit  button  is
             activated.  Equivalent to the -print option.

     Widget specific resources:

     showUnselectable (class 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
             fieldN.menu.options.showUnselectable,          class
             MenuButton.SimpleMenu.Options.ShowUnselectable;
             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 char-
             acters  in  font)  and  False  for field 11.  If you
             never   want   to    see    unselectable    entries,
             '*menu.options.showUnselectable:False'  is a reason-
             able thing to specify in a resource file.

2 BUGS
     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  out-
     put, though possibly resulting in no matching font.

     Should be able to return a FONT for the  PRIMARY  selection,
     not just a STRING.

     Any change in a field value will cause  _x_f_o_n_t_s_e_l  to  assert
     ownership  of  the  PRIMARY_FONT  selection.   Perhaps  this
     should be parameterized.

     When running on a slow machine, it is possible for the  user
     to request a field menu before the font names have been com-
     pletely parsed.  An error message indicating a missing  menu
     is  printed  to  stderr  but otherwise nothing bad (or good)
     happens.

2 COPYRIGHT
     Copyright 1989 by the Massachusetts Institute of Technology
     See _X(_1) for a full statement of rights and permissions.

2 AUTHOR
     Ralph R. Swick, Digital  Equipment  Corporation/MIT  Project
     Athena
