home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / twm.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  76.9 KB  |  1,915 lines

  1.  
  2.  
  3.  
  4. TWM(1)                               TWM(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        twm - Tab Window Manager for the X Window System
  9.  
  10. SSYYNNTTAAXX
  11.        ttwwmm [ --ddiissppllaayy _d_p_y ] [ --ss ] [ --ff _i_n_i_t_f_i_l_e ] [ --vv ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _T_w_m  is a window manager for the X Window System.  It pro-
  15.        vides titlebars, shaped windows,     several  forms     of  icon
  16.        management,  user-defined  macro     functions, click-to-type
  17.        and pointer-driven keyboard focus, and user-specified  key
  18.        and pointer button bindings.
  19.  
  20.        This program is usually started by the user's session man-
  21.        ager or startup script.    When used from _x_d_m_(_1_) or _x_i_n_i_t_(_1_)
  22.        without    a  session manager, _t_w_m is frequently executed in
  23.        the foreground as the last client.   When  run  this  way,
  24.        exiting    _t_w_m  causes  the  session to be terminated (i.e.,
  25.        logged out).
  26.  
  27.        By  default,  application  windows  are    surrounded  by    a
  28.        ``frame''  with a titlebar at the top and a special border
  29.        around the window.  The    titlebar  contains  the     window's
  30.        name, a rectangle that is lit when the window is receiving
  31.        keyboard input, and function boxes  known  as  ``titlebut-
  32.        tons'' at the left and right edges of the titlebar.
  33.  
  34.        Pressing     pointer  Button1  (usually  the left-most button
  35.        unless it has been changed with _x_m_o_d_m_a_p) on a  titlebutton
  36.        will  invoke  the function associated with the button.  In
  37.        the default interface, windows are iconified  by     clicking
  38.        (pressing  and then immediately releasing) the left title-
  39.        button (which looks like a Dot).     Conversely, windows  are
  40.        deiconified by clicking in the associated icon or entry in
  41.        the icon manager (see description of  the  variable  SShhooww--
  42.        IIccoonnMMaannaaggeerr and of the function ff..sshhoowwiiccoonnmmggrr).
  43.  
  44.        Windows    are  resized  by  pressing  the right titlebutton
  45.        (which resembles a group of nested squares), dragging  the
  46.        pointer    over  edge that is to be moved, and releasing the
  47.        pointer when the outline of  the     window     is  the  desired
  48.        size.   Similarly,  windows  are     moved by pressing in the
  49.        title or highlight region, dragging a  window  outline  to
  50.        the  new     location, and then releasing when the outline is
  51.        in the desired position.     Just clicking in  the    title  or
  52.        highlight region raises the window without moving it.
  53.  
  54.        When  new windows are created, _t_w_m will honor any size and
  55.        location     information  requested     by  the  user     (usually
  56.        through    _-_g_e_o_m_e_t_r_y  command line argument or resources for
  57.        the individual applications).  Otherwise,  an  outline  of
  58.        the  window's default size, its titlebar, and lines divid-
  59.        ing the window into a 3x3 grid that track the pointer  are
  60.        displayed.   Clicking  pointer  Button1    will position the
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TWM(1)                               TWM(1)
  71.  
  72.  
  73.        window at the current position and  give     it  the  default
  74.        size.    Pressing  pointer  Button2  (usually  the  middle
  75.        pointer button) and dragging the     outline  will    give  the
  76.        window  its  current  position  but  allow the sides to be
  77.        resized as  described  above.   Clicking     pointer  Button3
  78.        (usually     the  right  pointer button) will give the window
  79.        its current position but attempt to make it long enough to
  80.        touch the bottom the screen.
  81.  
  82. OOPPTTIIOONNSS
  83.        _T_w_m accepts the following command line options:
  84.  
  85.  
  86.        --ddiissppllaayy _d_p_y
  87.            This option specifies the X server to use.
  88.  
  89.        --ss      This option indicates that only the default screen
  90.            (as specified by --ddiissppllaayy or by the DDIISSPPLLAAYY  envi-
  91.            ronment    variable) should be managed.  By default,
  92.            _t_w_m will attempt to manage all screens on the dis-
  93.            play.
  94.  
  95.        --ff _f_i_l_e_n_a_m_e
  96.            This option specifies the name of the startup file
  97.            to use.    By default, _t_w_m will look in  the  user's
  98.            home  directory    for files named _._t_w_m_r_c_._n_u_m (where
  99.            _n_u_m is a screen number) or _._t_w_m_r_c.
  100.  
  101.        --vv      This option indicates that _t_w_m should print  error
  102.            messages     whenever  an unexpected X Error event is
  103.            received.   This     can  be  useful  when    debugging
  104.            applications  but  can  be  distracting in regular
  105.            use.
  106.  
  107. CCUUSSTTOOMMIIZZAATTIIOONN
  108.        Much of _t_w_m's appearance and behavior can be controlled by
  109.        providing a startup file in one of the following locations
  110.        (searched in order for each screen being managed when  _t_w_m
  111.        begins):
  112.  
  113.        $$HHOOMMEE//..ttwwmmrrcc.._s_c_r_e_e_n_n_u_m_b_e_r
  114.            The  _s_c_r_e_e_n_n_u_m_b_e_r is a small positive number (e.g.
  115.            0, 1, etc.)  representing the screen number  (e.g.
  116.            the  last  number in the DISPLAY environment vari-
  117.            able _h_o_s_t_:_d_i_s_p_l_a_y_n_u_m_._s_c_r_e_e_n_n_u_m) that would be used
  118.            to  contact  that  screen of the display.  This is
  119.            intended for displays  with  multiple  screens  of
  120.            differing visual types.
  121.  
  122.        $$HHOOMMEE//..ttwwmmrrcc
  123.            This  is     the  usual name for an individual user's
  124.            startup file.
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TWM(1)                               TWM(1)
  137.  
  138.  
  139.        <<XXRRoooott>>//lliibb//XX1111//ttwwmm//ssyysstteemm..ttwwmmrrcc
  140.            If neither of the preceding files are  found,  _t_w_m
  141.            will  look  in  this file for a default configura-
  142.            tion.  This is often tailored by the site adminis-
  143.            trator  to  provide  convenient    menus or familiar
  144.            bindings for novice users.  <XRoot> refers to  the
  145.            root of the X11 install tree.
  146.  
  147.        If  no  startup files are found, _t_w_m will use the built-in
  148.        defaults described above.  The only resource used  by  _t_w_m
  149.        is  _b_i_t_m_a_p_F_i_l_e_P_a_t_h  for a colon-separated list of directo-
  150.        ries to search when looking for    bitmap    files  (for  more
  151.        information, see the _A_t_h_e_n_a _W_i_d_g_e_t_s manual and _x_r_d_b_(_1_)).
  152.  
  153.        _T_w_m startup files are logically broken up into three types
  154.        of specifications:  _V_a_r_i_a_b_l_e_s, _B_i_n_d_i_n_g_s, _M_e_n_u_s.    The _V_a_r_i_-
  155.        _a_b_l_e_s  section must come first and is used to describe the
  156.        fonts, colors, cursors, border  widths,    icon  and  window
  157.        placement,  highlighting,  autoraising,    layout of titles,
  158.        warping, use of the icon manager.   The    _B_i_n_d_i_n_g_s  section
  159.        usually    comes second and is used to specify the functions
  160.        that should be to be invoked  when  keyboard  and  pointer
  161.        buttons are pressed in windows, icons, titles, and frames.
  162.        The _M_e_n_u_s section gives any user-defined menus (containing
  163.        functions to be invoked or commands to be executed).
  164.  
  165.        Variable names and keywords are case-insensitive.  Strings
  166.        must  be     surrounded  by     double     quote    characters  (e.g.
  167.        "blue")    and are case-sensitive.     A pound sign (#) outside
  168.        of a string causes the remainder of the line in which  the
  169.        character appears to be treated as a comment.
  170.  
  171. VVAARRIIAABBLLEESS
  172.        Many of the aspects of _t_w_m's user interface are controlled
  173.        by variables that may be set in the user's  startup  file.
  174.        Some  of the options are enabled or disabled simply by the
  175.        presence of a particular keyword.  Other     options  require
  176.        keywords, numbers, strings, or lists of all of these.
  177.  
  178.        Lists  are  surrounded by braces and are usually separated
  179.        by whitespace or a newline.  For example:
  180.  
  181.         AAuuttooRRaaiissee { "emacs" "XTerm" "Xmh" }
  182.  
  183.        or
  184.  
  185.         AAuuttooRRaaiissee
  186.         {
  187.          "emacs"
  188.          "XTerm"
  189.          "Xmh"
  190.         }
  191.  
  192.        When a variable containing a list of strings  representing
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. TWM(1)                               TWM(1)
  203.  
  204.  
  205.        windows    is  searched (e.g. to determine whether or not to
  206.        enable autoraise as shown above),  a  string  must  be  an
  207.        exact, case-sensitive match to the window's name (given by
  208.        the WM_NAME window property), resource name or class  name
  209.        (both given by the WM_CLASS window property).  The preced-
  210.        ing  example  would  enable  autoraise  on  windows  named
  211.        ``emacs''  as  well  as any _x_t_e_r_m (since they are of class
  212.        ``XTerm'') or xmh windows (which are of class ``Xmh'').
  213.  
  214.        String arguments that are interpreted  as  filenames  (see
  215.        the   PPiixxmmaappss,  CCuurrssoorrss,     and  IIccoonnDDiirreeccttoorryy  below)  will
  216.        prepend the user's directory (specified by the HHOOMMEE  envi-
  217.        ronment    variable)  if the first character is a tilde (~).
  218.        If, instead, the first character is a colon (:), the  name
  219.        is  assumed  to    refer to one of the internal bitmaps that
  220.        are used to create the default titlebars symbols:   ::xxllooggoo
  221.        or  ::ddeelleettee  (both  refer to the X logo), ::ddoott or ::iiccoonniiffyy
  222.        (both refer to the dot), ::rreessiizzee (the nested squares  used
  223.        by  the    resize    button),  ::mmeennuu     (a page with lines), and
  224.        ::qquueessttiioonn (the question mark used for non-existent  bitmap
  225.        files).
  226.  
  227.        The  following  variables may be specified at the top of a
  228.        _t_w_m startup file.  Lists of Window name prefix strings are
  229.        indicated  by  _w_i_n_-_l_i_s_t.      Optional arguments are shown in
  230.        square brackets:
  231.  
  232.        AAuuttooRRaaiissee { _w_i_n_-_l_i_s_t }
  233.            This variable specifies a  list    of  windows  that
  234.            should    automatically    be  raised  whenever  the
  235.            pointer enters the window.   This  action  can  be
  236.            interactively  enabled  or  disabled on individual
  237.            windows using the function ff..aauuttoorraaiissee.
  238.  
  239.        AAuuttooRReellaattiivveeRReessiizzee
  240.            This variable indicates that dragging out a window
  241.            size (either when initially sizing the window with
  242.            pointer Button2 or when resizing     it)  should  not
  243.            wait  until  the     pointer  has  crossed the window
  244.            edges.  Instead, moving the pointer  automatically
  245.            causes  the  nearest  edge or edges to move by the
  246.            same amount.  This allows the resizing of  windows
  247.            that  extend  off  the edge of the screen.  If the
  248.            pointer is in the center of the window, or if  the
  249.            resize  is  begun  by  pressing a titlebutton, _t_w_m
  250.            will still wait for the pointer to cross a  window
  251.            edge  (to prevent accidents).  This option is par-
  252.            ticularly useful for people who    like  the  press-
  253.            drag-release  method of sweeping out window sizes.
  254.  
  255.        BBoorrddeerrCCoolloorr _s_t_r_i_n_g [{ _w_i_n_c_o_l_o_r_l_i_s_t }]
  256.            This variable specifies the default color  of  the
  257.            border  to be placed around all non-iconified win-
  258.            dows, and  may  only  be     given    within    a  CCoolloorr,
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. TWM(1)                               TWM(1)
  269.  
  270.  
  271.            GGrraayyssccaallee  or  MMoonnoocchhrroommee list.    The optional _w_i_n_-
  272.            _c_o_l_o_r_l_i_s_t specifies a list  of  window  and  color
  273.            name pairs for specifying particular border colors
  274.            for different types of windows.    For example:
  275.  
  276.             BBoorrddeerrCCoolloorr "gray50"
  277.             {
  278.              "XTerm"   "red"
  279.              "xmh"       "green"
  280.             }
  281.  
  282.            The default is "black".
  283.  
  284.        BBoorrddeerrTTiilleeBBaacckkggrroouunndd _s_t_r_i_n_g [{ _w_i_n_c_o_l_o_r_l_i_s_t }]
  285.            This variable  specifies     the  default  background
  286.            color  in  the  gray pattern used in unhighlighted
  287.            borders (only if NNooHHiigghhlliigghhtt hasn't been set), and
  288.            may  only  be  given  within a CCoolloorr, GGrraayyssccaallee or
  289.            MMoonnoocchhrroommee list.     The optional _w_i_n_c_o_l_o_r_l_i_s_t allows
  290.            per-window  colors  to  be specified.  The default
  291.            is "white".
  292.  
  293.        BBoorrddeerrTTiilleeFFoorreeggrroouunndd _s_t_r_i_n_g [{ _w_i_n_c_o_l_o_r_l_i_s_t }]
  294.            This variable  specifies     the  default  foreground
  295.            color  in  the  gray pattern used in unhighlighted
  296.            borders (only if NNooHHiigghhlliigghhtt hasn't been set), and
  297.            may  only  be  given  within a CCoolloorr, GGrraayyssccaallee or
  298.            MMoonnoocchhrroommee list.     The optional _w_i_n_c_o_l_o_r_l_i_s_t allows
  299.            per-window colors to be specified.  The default is
  300.            "black".
  301.  
  302.        BBoorrddeerrWWiiddtthh _p_i_x_e_l_s
  303.            This variable specifies the width in pixels of the
  304.            border  surrounding  all     client     window frames if
  305.            CClliieennttBBoorrddeerrWWiiddtthh has not  been    specified.   This
  306.            value  is also used to set the border size of win-
  307.            dows created by _t_w_m (such as  the  icon    manager).
  308.            The default is 2.
  309.  
  310.        BBuuttttoonnIInnddeenntt _p_i_x_e_l_s
  311.            This variable specifies the amount by which title-
  312.            buttons should be indented on all sides.     Positive
  313.            values  cause  the  buttons to be smaller than the
  314.            window text and highlight area so that they  stand
  315.            out.   Setting this and the TTiittlleeBBuuttttoonnBBoorrddeerrWWiiddtthh
  316.            variables to 0 makes titlebuttons be as    tall  and
  317.            wide as possible.  The default is 1.
  318.  
  319.        CClliieennttBBoorrddeerrWWiiddtthh
  320.            This  variable  indicates  that    border width of a
  321.            window's frame should be set to the initial border
  322.            width  of  the window, rather than to the value of
  323.            BBoorrddeerrWWiiddtthh.
  324.  
  325.  
  326.  
  327.  
  328. X Version 11           Release 6.1                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. TWM(1)                               TWM(1)
  335.  
  336.  
  337.        CCoolloorr { _c_o_l_o_r_s_-_l_i_s_t }
  338.            This variable specifies a list  of  color  assign-
  339.            ments to be made if the default display is capable
  340.            of displaying more than simple  black  and  white.
  341.            The  _c_o_l_o_r_s_-_l_i_s_t is made up of the following color
  342.            variables  and  their  values:  DDeeffaauullttBBaacckkggrroouunndd,
  343.            DDeeffaauullttFFoorreeggrroouunndd, MMeennuuBBaacckkggrroouunndd, MMeennuuFFoorreeggrroouunndd,
  344.            MMeennuuTTiittlleeBBaacckkggrroouunndd,         MMeennuuTTiittlleeFFoorreeggrroouunndd,
  345.            MMeennuuSShhaaddoowwCCoolloorr,     PPooiinntteerrFFoorreeggrroouunndd,  and PPooiinntteerr--
  346.            BBaacckkggrroouunndd.  The     following  color  variables  may
  347.            also  be     given    a  list     of window and color name
  348.            pairs to allow per-window colors to  be    specified
  349.            (see  BBoorrddeerrCCoolloorr for details): BBoorrddeerrCCoolloorr, IIccoonn--
  350.            MMaannaaggeerrHHiigghhlliigghhtt, BBoorrddeerrTTiittlleeBBaacckkggrroouunndd, BBoorrddeerrTTii--
  351.            ttlleeFFoorreeggrroouunndd,  TTiittlleeBBaacckkggrroouunndd,     TTiittlleeFFoorreeggrroouunndd,
  352.            IIccoonnBBaacckkggrroouunndd,    IIccoonnFFoorreeggrroouunndd,     IIccoonnBBoorrddeerrCCoolloorr,
  353.            IIccoonnMMaannaaggeerrBBaacckkggrroouunndd,  and IIccoonnMMaannaaggeerrFFoorreeggrroouunndd.
  354.            For example:
  355.  
  356.             CCoolloorr
  357.             {
  358.              MenuBackground         "gray50"
  359.              MenuForeground         "blue"
  360.              BorderColor          "red" { "XTerm" "yellow" }
  361.              TitleForeground      "yellow"
  362.              TitleBackground      "blue"
  363.             }
  364.  
  365.            All of these color variables may also be specified
  366.            for  the     MMoonnoocchhrroommee  variable,    allowing the same
  367.            initialization file to be used on both  color  and
  368.            monochrome displays.
  369.  
  370.        CCoonnssttrraaiinneeddMMoovveeTTiimmee _m_i_l_l_i_s_e_c_o_n_d_s
  371.            This variable specifies the length of time between
  372.            button clicks needed to begin a    constrained  move
  373.            operation.   Double clicking within this amount of
  374.            time when invoking ff..mmoovvee will cause the window to
  375.            be  moved  only in a horizontal or vertical direc-
  376.            tion.  Setting this value to 0 will  disable  con-
  377.            strained     moves.     The default is 400 milliseconds.
  378.  
  379.        CCuurrssoorrss { _c_u_r_s_o_r_-_l_i_s_t }
  380.            This variable specifies the glyphs that _t_w_m should
  381.            use  for various pointer cursors.  Each cursor may
  382.            be defined either from the ccuurrssoorr font or from two
  383.            bitmap  files.  Shapes from the ccuurrssoorr font may be
  384.            specified directly as:
  385.  
  386.              _c_u_r_s_o_r_n_a_m_e    "_s_t_r_i_n_g"
  387.  
  388.            where _c_u_r_s_o_r_n_a_m_e is one of the cursor names listed
  389.            below,  and _s_t_r_i_n_g is the name of a glyph as found
  390.            in   the      file     <XRoot>/include/X11/cursorfont.h
  391.  
  392.  
  393.  
  394. X Version 11           Release 6.1                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. TWM(1)                               TWM(1)
  401.  
  402.  
  403.            (without the ``XC_'' prefix).  If the cursor is to
  404.            be defined from bitmap files, the following syntax
  405.            is used instead:
  406.  
  407.              _c_u_r_s_o_r_n_a_m_e    "_i_m_a_g_e"      "_m_a_s_k"
  408.  
  409.            The  _i_m_a_g_e  and    _m_a_s_k strings specify the names of
  410.            files containing     the  glyph  image  and     mask  in
  411.            _b_i_t_m_a_p_(_1_)  form.      The bitmap files are located in
  412.            the same manner as icon bitmap files.  The follow-
  413.            ing example shows the default cursor definitions:
  414.  
  415.             CCuurrssoorrss
  416.             {
  417.              Frame        "top_left_arrow"
  418.              Title        "top_left_arrow"
  419.              Icon       "top_left_arrow"
  420.              IconMgr   "top_left_arrow"
  421.              Move       "fleur"
  422.              Resize        "fleur"
  423.              Menu       "sb_left_arrow"
  424.              Button        "hand2"
  425.              Wait       "watch"
  426.              Select        "dot"
  427.              Destroy   "pirate"
  428.             }
  429.  
  430.  
  431.        DDeeccoorraatteeTTrraannssiieennttss
  432.            This  variable  indicates  that    transient windows
  433.            (those  containing  a  WM_TRANSIENT_FOR    property)
  434.            should have titlebars.  By default, transients are
  435.            not reparented.
  436.  
  437.        DDeeffaauullttBBaacckkggrroouunndd _s_t_r_i_n_g
  438.            This variable specifies the background color to be
  439.            used  for  sizing  and  information  windows.  The
  440.            default is "white".
  441.  
  442.        DDeeffaauullttFFoorreeggrroouunndd _s_t_r_i_n_g
  443.            This variable specifies the foreground color to be
  444.            used  for  sizing  and  information  windows.  The
  445.            default is "black".
  446.  
  447.        DDoonnttIIccoonniiffyyBByyUUnnmmaappppiinngg { _w_i_n_-_l_i_s_t }
  448.            This variable specifies a  list    of  windows  that
  449.            should  not  be    iconified by simply unmapping the
  450.            window (as would be the case if IIccoonniiffyyBByyUUnnmmaappppiinngg
  451.            had  been  set).     This is frequently used to force
  452.            some windows to be treated as  icons  while  other
  453.            windows are handled by the icon manager.
  454.  
  455.        DDoonnttMMoovveeOOffff
  456.            This variable indicates that windows should not be
  457.  
  458.  
  459.  
  460. X Version 11           Release 6.1                7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. TWM(1)                               TWM(1)
  467.  
  468.  
  469.            allowed to be moved off the  screen.   It  can  be
  470.            overridden by the ff..ffoorrcceemmoovvee function.
  471.  
  472.        DDoonnttSSqquueeeezzeeTTiittllee [{ _w_i_n_-_l_i_s_t }]
  473.            This  variable indicates that titlebars should not
  474.            be squeezed to their  minimum  size  as    described
  475.            under  SSqquueeeezzeeTTiittllee below.  If the optional window
  476.            list is supplied, only those windows will be  pre-
  477.            vented from being squeezed.
  478.  
  479.        FFoorrcceeIIccoonnss
  480.            This  variable  indicates that icon pixmaps speci-
  481.            fied in the IIccoonnss  variable  should  override  any
  482.            client-supplied pixmaps.
  483.  
  484.        FFrraammeePPaaddddiinngg _p_i_x_e_l_s
  485.            This  variable  specifies the distance between the
  486.            titlebar decorations (the button and text) and the
  487.            window frame.  The default is 2 pixels.
  488.  
  489.        GGrraayyssccaallee { _c_o_l_o_r_s }
  490.            This  variable  specifies  a list of color assign-
  491.            ments that should be made  if  the  screen  has    a
  492.            GrayScale  default visual.  See the description of
  493.            CCoolloorrss.
  494.  
  495.        IIccoonnBBaacckkggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  496.            This variable specifies the  background    color  of
  497.            icons,  and  may     only  be  specified  inside of a
  498.            CCoolloorr, GGrraayyssccaallee or MMoonnoocchhrroommee list.  The optional
  499.            _w_i_n_-_l_i_s_t     is  a list of window names and colors so
  500.            that per-window colors may be specified.     See  the
  501.            BBoorrddeerrCCoolloorr variable for a complete description of
  502.            the _w_i_n_-_l_i_s_t.  The default is "white".
  503.  
  504.        IIccoonnBBoorrddeerrCCoolloorr _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  505.            This variable specifies the color  of  the  border
  506.            used  for  icon windows, and may only be specified
  507.            inside of a CCoolloorr, GGrraayyssccaallee or    MMoonnoocchhrroommee  list.
  508.            The  optional  _w_i_n_-_l_i_s_t    is a list of window names
  509.            and colors so that per-window colors may be speci-
  510.            fied.  See the BBoorrddeerrCCoolloorr variable for a complete
  511.            description  of    the  _w_i_n_-_l_i_s_t.     The  default  is
  512.            "black".
  513.  
  514.        IIccoonnBBoorrddeerrWWiiddtthh _p_i_x_e_l_s
  515.            This variable specifies the width in pixels of the
  516.            border surrounding icon windows.     The  default  is
  517.            2.
  518.  
  519.        IIccoonnDDiirreeccttoorryy _s_t_r_i_n_g
  520.            This  variable specifies the directory that should
  521.            be searched if if a bitmap file cannot be found in
  522.            any  of    the  directories  in  the  bbiittmmaappFFiilleePPaatthh
  523.  
  524.  
  525.  
  526. X Version 11           Release 6.1                8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. TWM(1)                               TWM(1)
  533.  
  534.  
  535.            resource.
  536.  
  537.        IIccoonnFFoonntt _s_t_r_i_n_g
  538.            This variable specifies the font     to  be     used  to
  539.            display    icon  names within icons.  The default is
  540.            "variable".
  541.  
  542.        IIccoonnFFoorreeggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  543.            This variable specifies the foreground color to be
  544.            used when displaying icons, and may only be speci-
  545.            fied inside of a CCoolloorr,    GGrraayyssccaallee  or  MMoonnoocchhrroommee
  546.            list.   The  optional _w_i_n_-_l_i_s_t is a list of window
  547.            names and colors so that per-window colors may  be
  548.            specified.   See     the  BBoorrddeerrCCoolloorr  variable for a
  549.            complete description of the _w_i_n_-_l_i_s_t.  The default
  550.            is "black".
  551.  
  552.        IIccoonniiffyyBByyUUnnmmaappppiinngg [[{{ _w_i_n_-_l_i_s_t }}]]
  553.            This  variable  indicates  that    windows should be
  554.            iconified by being unmapped without trying to  map
  555.            any  icons.  This assumes that the user will remap
  556.            the window through the icon manager, the     ff..wwaarrppttoo
  557.            function, or the _T_w_m_W_i_n_d_o_w_s menu.  If the optional
  558.            _w_i_n_-_l_i_s_t is provided, only those windows     will  be
  559.            iconified  by simply unmapping.    Windows that have
  560.            both this and the IIccoonnMMaannaaggeerrDDoonnttSShhooww options  set
  561.            may not be accessible if no binding to the _T_w_m_W_i_n_-
  562.            _d_o_w_s menu is set in the user's startup file.
  563.  
  564.        IIccoonnMMaannaaggeerrBBaacckkggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  565.            This variable specifies the  background    color  to
  566.            use  for     icon  manager    entries,  and may only be
  567.            specified  inside  of  a      CCoolloorr,   GGrraayyssccaallee   or
  568.            MMoonnoocchhrroommee  list.  The optional _w_i_n_-_l_i_s_t is a list
  569.            of window names and colors so that per-window col-
  570.            ors  may     be specified.    See the BBoorrddeerrCCoolloorr vari-
  571.            able for a complete description of  the    _w_i_n_-_l_i_s_t.
  572.            The default is "white".
  573.  
  574.        IIccoonnMMaannaaggeerrDDoonnttSShhooww [{ _w_i_n_-_l_i_s_t }]
  575.            This  variable  indicates  that    the  icon manager
  576.            should not display any windows.    If  the     optional
  577.            _w_i_n_-_l_i_s_t     is given, only those windows will not be
  578.            displayed.  This variable is used to prevent  win-
  579.            dows  that are rarely iconified (such as _x_c_l_o_c_k or
  580.            _x_l_o_a_d) from taking up space in the icon manager.
  581.  
  582.        IIccoonnMMaannaaggeerrFFoonntt _s_t_r_i_n_g
  583.            This variable specifies the font to be  used  when
  584.            displaying  icon     manager entries.  The default is
  585.            "variable".
  586.  
  587.        IIccoonnMMaannaaggeerrFFoorreeggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  588.            This variable specifies the foreground color to be
  589.  
  590.  
  591.  
  592. X Version 11           Release 6.1                9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. TWM(1)                               TWM(1)
  599.  
  600.  
  601.            used when displaying icon manager entries, and may
  602.            only be specified inside of a CCoolloorr, GGrraayyssccaallee  or
  603.            MMoonnoocchhrroommee  list.  The optional _w_i_n_-_l_i_s_t is a list
  604.            of window names and colors so that per-window col-
  605.            ors  may     be specified.    See the BBoorrddeerrCCoolloorr vari-
  606.            able for a complete description of  the    _w_i_n_-_l_i_s_t.
  607.            The default is "black".
  608.  
  609.        IIccoonnMMaannaaggeerrGGeeoommeettrryy _s_t_r_i_n_g [ _c_o_l_u_m_n_s ]
  610.            This  variable  specifies the geometry of the icon
  611.            manager window.    The _s_t_r_i_n_g argument  is     standard
  612.            geometry     specification that indicates the initial
  613.            full size of the icon manager.  The  icon  manager
  614.            window  is  then     broken     into  _c_o_l_u_m_n_s pieces and
  615.            scaled according to the number of entries  in  the
  616.            icon  manager.    Extra entries are wrapped to form
  617.            additional rows.     The default number of columns is
  618.            1.
  619.  
  620.        IIccoonnMMaannaaggeerrHHiigghhlliigghhtt _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  621.            This  variable  specifies  the  border color to be
  622.            used when highlighting the icon manager entry that
  623.            currently has the focus, and can only be specified
  624.            inside of a CCoolloorr, GGrraayyssccaallee or    MMoonnoocchhrroommee  list.
  625.            The  optional  _w_i_n_-_l_i_s_t    is a list of window names
  626.            and colors so that per-window colors may be speci-
  627.            fied.  See the BBoorrddeerrCCoolloorr variable for a complete
  628.            description  of    the  _w_i_n_-_l_i_s_t.     The  default  is
  629.            "black".
  630.  
  631.        IIccoonnMMaannaaggeerrss { _i_c_o_n_m_g_r_-_l_i_s_t }
  632.            This variable specifies a list of icon managers to
  633.            create.    Each item in  the  _i_c_o_n_m_g_r_-_l_i_s_t     has  the
  634.            following format:
  635.  
  636.              "_w_i_n_n_a_m_e" ["_i_c_o_n_n_a_m_e"]      "_g_e_o_m_e_t_r_y" _c_o_l_u_m_n_s
  637.  
  638.            where  _w_i_n_n_a_m_e  is  the    name  of the windows that
  639.            should be put into this icon manager, _i_c_o_n_n_a_m_e  is
  640.            the name of that icon manager window's icon, _g_e_o_m_-
  641.            _e_t_r_y is a  standard  geometry  specification,  and
  642.            _c_o_l_u_m_n_s is the number of columns in this icon man-
  643.            ager as    described  in  IIccoonnMMaannaaggeerrGGeeoommeettrryy.   For
  644.            example:
  645.  
  646.             IIccoonnMMaannaaggeerrss
  647.             {
  648.              "XTerm"   "=300x5+800+5" 5
  649.              "myhost"  "=400x5+100+5" 2
  650.             }
  651.  
  652.            Clients whose name or class is ``XTerm'' will have
  653.            an entry created in the    ``XTerm''  icon     manager.
  654.            Clients    whose  name  was  ``myhost'' would be put
  655.  
  656.  
  657.  
  658. X Version 11           Release 6.1                   10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. TWM(1)                               TWM(1)
  665.  
  666.  
  667.            into the ``myhost'' icon manager.
  668.  
  669.        IIccoonnMMaannaaggeerrSShhooww { _w_i_n_-_l_i_s_t }
  670.            This variable specifies a  list    of  windows  that
  671.            should  appear  in the icon manager.  When used in
  672.            conjunction with the IIccoonnMMaannaaggeerrDDoonnttSShhooww variable,
  673.            only the windows in this list will be shown in the
  674.            icon manager.
  675.  
  676.        IIccoonnRReeggiioonn _g_e_o_m_s_t_r_i_n_g _v_g_r_a_v _h_g_r_a_v _g_r_i_d_w_i_d_t_h _g_r_i_d_h_e_i_g_h_t
  677.            This variable specifies an area on the root window
  678.            in  which  icons     are  placed  if no specific icon
  679.            location is provided by    the  client.   The  _g_e_o_m_-
  680.            _s_t_r_i_n_g  is  a  quoted string containing a standard
  681.            geometry specification.    If more than one  IIccoonnRRee--
  682.            ggiioonn  lines  are given, icons will be put into the
  683.            succeeding icon regions when the     first    is  full.
  684.            The _v_g_r_a_v argument should be either NNoorrtthh or SSoouutthh
  685.            and control and is used to control  whether  icons
  686.            are  first filled in from the top or bottom of the
  687.            icon region.  Similarly, the _h_g_r_a_v argument should
  688.            be  either  EEaasstt     or  WWeesstt  and is used to control
  689.            whether icons should be filled in from  left  from
  690.            the  right.   Icons are laid out within the region
  691.            in a grid with cells  _g_r_i_d_w_i_d_t_h    pixels    wide  and
  692.            _g_r_i_d_h_e_i_g_h_t pixels high.
  693.  
  694.        IIccoonnss { _w_i_n_-_l_i_s_t }
  695.            This variable specifies a list of window names and
  696.            the bitmap filenames that should be used as  their
  697.            icons.  For example:
  698.  
  699.             IIccoonnss
  700.             {
  701.              "XTerm"   "xterm.icon"
  702.              "xfd"        "xfd_icon"
  703.             }
  704.  
  705.            Windows    that  match  ``XTerm''    and  would not be
  706.            iconified by unmapping, and would try to     use  the
  707.            icon bitmap in the file ``xterm.icon''.    If FFoorrccee--
  708.            IIccoonnss is specified, this bitmap will be used  even
  709.            if the client has requested its own icon pixmap.
  710.  
  711.        IInntteerrppoollaatteeMMeennuuCCoolloorrss
  712.            This  variable  indicates  that    menu entry colors
  713.            should be  interpolated    between     entry    specified
  714.            colors.    In the example below:
  715.  
  716.             MMeennuu "mymenu"
  717.             {
  718.              "Title"    ("black":"red")         f.title
  719.              "entry1"          f.nop
  720.              "entry2"          f.nop
  721.  
  722.  
  723.  
  724. X Version 11           Release 6.1                   11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. TWM(1)                               TWM(1)
  731.  
  732.  
  733.              "entry3"  ("white":"green")   f.nop
  734.              "entry4"          f.nop
  735.              "entry5"  ("red":"white")        f.nop
  736.             }
  737.  
  738.            the   foreground      colors   for     ``entry1''   and
  739.            ``entry2'' will be interpolated between black  and
  740.            white,  and  the background colors between red and
  741.            green.  Similarly, the foreground  for  ``entry4''
  742.            will  be     half-way  between white and red, and the
  743.            background will    be  half-way  between  green  and
  744.            white.
  745.  
  746.        MMaakkeeTTiittllee { _w_i_n_-_l_i_s_t }
  747.            This variable specifies a list of windows on which
  748.            a titlebar should be placed and is used to request
  749.            titles  on  specific windows when NNooTTiittllee has been
  750.            set.
  751.  
  752.        MMaaxxWWiinnddoowwSSiizzee _s_t_r_i_n_g
  753.            This variable specifies a geometry  in  which  the
  754.            width and height give the maximum size for a given
  755.            window.    This is typically used to  restrict  win-
  756.            dows to the size of the screen.    The default width
  757.            is 32767 - screen width.     The  default  height  is
  758.            32767 - screen height.
  759.  
  760.        MMeennuuBBaacckkggrroouunndd _s_t_r_i_n_g
  761.            This  variable specifies the background color used
  762.            for menus, and can only be specified inside  of    a
  763.            CCoolloorr or MMoonnoocchhrroommee list.  The default is "white".
  764.  
  765.        MMeennuuFFoonntt _s_t_r_i_n_g
  766.            This variable specifies the font to use when  dis-
  767.            playing menus.  The default is "variable".
  768.  
  769.        MMeennuuFFoorreeggrroouunndd _s_t_r_i_n_g
  770.            This  variable specifies the foreground color used
  771.            for menus, and can only be specified inside  of    a
  772.            CCoolloorr,  GGrraayyssccaallee or MMoonnoocchhrroommee list.  The default
  773.            is "black".
  774.  
  775.        MMeennuuSShhaaddoowwCCoolloorr _s_t_r_i_n_g
  776.            This variable specifies the color  of  the  shadow
  777.            behind  pull-down  menus and can only be specified
  778.            inside of a CCoolloorr, GGrraayyssccaallee or    MMoonnoocchhrroommee  list.
  779.            The default is "black".
  780.  
  781.        MMeennuuTTiittlleeBBaacckkggrroouunndd _s_t_r_i_n_g
  782.            This  variable  specifies the background color for
  783.            ff..ttiittllee entries in menus, and can only  be  speci-
  784.            fied  inside  of     a CCoolloorr, GGrraayyssccaallee or MMoonnoocchhrroommee
  785.            list.  The default is "white".
  786.  
  787.  
  788.  
  789.  
  790. X Version 11           Release 6.1                   12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. TWM(1)                               TWM(1)
  797.  
  798.  
  799.        MMeennuuTTiittlleeFFoorreeggrroouunndd _s_t_r_i_n_g
  800.            This variable specifies the foreground  color  for
  801.            ff..ttiittllee entries in menus and can only be specified
  802.            inside of a CCoolloorr or MMoonnoocchhrroommee list.  The default
  803.            is "black".
  804.  
  805.        MMoonnoocchhrroommee { _c_o_l_o_r_s }
  806.            This  variable  specifies  a list of color assign-
  807.            ments that should be made  if  the  screen  has    a
  808.            depth of 1.  See the description of CCoolloorrss.
  809.  
  810.        MMoovveeDDeellttaa _p_i_x_e_l_s
  811.            This  variable  specifies the number of pixels the
  812.            pointer    must  move  before  the     ff..mmoovvee     function
  813.            starts  working.      Also    see the ff..ddeellttaassttoopp func-
  814.            tion.  The default is zero pixels.
  815.  
  816.        NNooBBaacckkiinnggSSttoorree
  817.            This variable indicates that  _t_w_m's  menus  should
  818.            not  request  backing store to minimize repainting
  819.            of menus.  This is  typically  used  with  servers
  820.            that can repaint faster than they can handle back-
  821.            ing store.
  822.  
  823.        NNooCCaasseeSSeennssiittiivvee
  824.            This  variable  indicates  that    case  should   be
  825.            ignored    when  sorting  icon names in an icon man-
  826.            ager.  This option is typically used with applica-
  827.            tions  that  capitalize    the first letter of their
  828.            icon name.
  829.  
  830.        NNooDDeeffaauullttss
  831.            This variable indicates that _t_w_m should not supply
  832.            the   default  titlebuttons  and     bindings.   This
  833.            option should only be used  if  the  startup  file
  834.            contains a completely new set of bindings and def-
  835.            initions.
  836.  
  837.        NNooGGrraabbSSeerrvveerr
  838.            This variable indicates that _t_w_m should    not  grab
  839.            the server when popping up menus and moving opaque
  840.            windows.
  841.  
  842.        NNooHHiigghhlliigghhtt [{ _w_i_n_-_l_i_s_t }]
  843.            This variable indicates that borders should not be
  844.            highlighted  to track the location of the pointer.
  845.            If the optional _w_i_n_-_l_i_s_t     is  given,  highlighting
  846.            will only be disabled for those windows.     When the
  847.            border is highlighted, it will  be  drawn  in  the
  848.            current BBoorrddeerrCCoolloorr.  When the border is not high-
  849.            lighted, it will be stippled with a  gray  pattern
  850.            using the current BBoorrddeerrTTiilleeFFoorreeggrroouunndd and BBoorrddeerr--
  851.            TTiilleeBBaacckkggrroouunndd colors.
  852.  
  853.  
  854.  
  855.  
  856. X Version 11           Release 6.1                   13
  857.  
  858.  
  859.  
  860.  
  861.  
  862. TWM(1)                               TWM(1)
  863.  
  864.  
  865.        NNooIIccoonnMMaannaaggeerrss
  866.            This  variable  indicates  that    no  icon  manager
  867.            should be created.
  868.  
  869.        NNooMMeennuuSShhaaddoowwss
  870.            This variable indicates that menus should not have
  871.            drop shadows drawn behind them.    This is typically
  872.            used  with  slower servers since it speeds up menu
  873.            drawing at the expense of making the menu slightly
  874.            harder to read.
  875.  
  876.        NNooRRaaiisseeOOnnDDeeiiccoonniiffyy
  877.            This  variable  indicates  that    windows     that are
  878.            deiconified should not be raised.
  879.  
  880.        NNooRRaaiisseeOOnnMMoovvee
  881.            This variable indicates that windows should not be
  882.            raised  when  moved.   This  is    typically used to
  883.            allow windows to slide underneath each other.
  884.  
  885.        NNooRRaaiisseeOOnnRReessiizzee
  886.            This variable indicates that windows should not be
  887.            raised  when  resized.    This is typically used to
  888.            allow windows to be resized underneath each other.
  889.  
  890.        NNooRRaaiisseeOOnnWWaarrpp
  891.            This variable indicates that windows should not be
  892.            raised when the pointer is warped into  them  with
  893.            the  ff..wwaarrppttoo  function.      If  this option is set,
  894.            warping to an occluded window may  result  in  the
  895.            pointer    ending up in the occluding window instead
  896.            the desired window (which causes unexpected behav-
  897.            ior with ff..wwaarrpprriinngg).
  898.  
  899.        NNooSSaavveeUUnnddeerrss
  900.            This  variable  indicates  that    menus  should not
  901.            request save-unders to minimize window  repainting
  902.            following  menu    selection.   It is typically used
  903.            with displays that can repaint  faster  than  they
  904.            can handle save-unders.
  905.  
  906.        NNooSSttaacckkMMooddee [{ _w_i_n_-_l_i_s_t }]
  907.            This   variable     indicates   that  client  window
  908.            requests     to  change  stacking  order  should   be
  909.            ignored.      If the optional _w_i_n_-_l_i_s_t is given, only
  910.            requests on those windows will be  ignored.   This
  911.            is  typically  used  to    prevent applications from
  912.            relentlessly popping themselves to  the    front  of
  913.            the window stack.
  914.  
  915.        NNooTTiittllee [{ _w_i_n_-_l_i_s_t }]
  916.            This  variable  indicates  that windows should not
  917.            have  titlebars.      If  the  optional  _w_i_n_-_l_i_s_t  is
  918.            given, only those windows will not have titlebars.
  919.  
  920.  
  921.  
  922. X Version 11           Release 6.1                   14
  923.  
  924.  
  925.  
  926.  
  927.  
  928. TWM(1)                               TWM(1)
  929.  
  930.  
  931.            MMaakkeeTTiittllee may be used with this    option    to  force
  932.            titlebars to be put on specific windows.
  933.  
  934.        NNooTTiittlleeFFooccuuss
  935.            This  variable  indicates  that _t_w_m should not set
  936.            keyboard input focus  to     each  window  as  it  is
  937.            entered.      Normally,  _t_w_m  sets    the focus so that
  938.            focus and key events from the  titlebar    and  icon
  939.            managers are delivered to the application.  If the
  940.            pointer is  moved  quickly  and    _t_w_m  is     slow  to
  941.            respond,     input    can be directed to the old window
  942.            instead of the new.  This option is typically used
  943.            to  prevent  this ``input lag'' and to work around
  944.            bugs in older applications that have problems with
  945.            focus events.
  946.  
  947.        NNooTTiittlleeHHiigghhlliigghhtt [{ _w_i_n_-_l_i_s_t }]
  948.            This variable indicates that the highlight area of
  949.            the titlebar, which is used to indicate the window
  950.            that  currently has the input focus, should not be
  951.            displayed.  If the  optional  _w_i_n_-_l_i_s_t  is  given,
  952.            only  those windows will not have highlight areas.
  953.            This and the SSqquueeeezzeeTTiittllee options can  be  set  to
  954.            substantially  reduce  the  amount of screen space
  955.            required by titlebars.
  956.  
  957.        OOppaaqquueeMMoovvee
  958.            This variable indicates that the     ff..mmoovvee     function
  959.            should actually move the window instead of just an
  960.            outline so that the user can immediately see  what
  961.            the  window  will  look    like in the new position.
  962.            This option is typically     used  on  fast     displays
  963.            (particularly if NNooGGrraabbSSeerrvveerr is set).
  964.  
  965.        PPiixxmmaappss { _p_i_x_m_a_p_s }
  966.            This  variable  specifies  a  list of pixmaps that
  967.            define the appearance  of  various  images.   Each
  968.            entry  is  a keyword indicating the pixmap to set,
  969.            followed by a string giving the name of the bitmap
  970.            file.  The following pixmaps may be specified:
  971.  
  972.             PPiixxmmaappss
  973.             {
  974.              TitleHighlight "gray1"
  975.             }
  976.  
  977.            The  default  for _T_i_t_l_e_H_i_g_h_l_i_g_h_t is to use an even
  978.            stipple pattern.
  979.  
  980.        PPrriioorriittyy _p_r_i_o_r_i_t_y
  981.            This  variable  sets  _t_w_m's  priority.     _p_r_i_o_r_i_t_y
  982.            should  be  an unquoted, signed number (e.g. 999).
  983.            This variable has an effect  only  if  the  server
  984.            supports the SYNC extension.
  985.  
  986.  
  987.  
  988. X Version 11           Release 6.1                   15
  989.  
  990.  
  991.  
  992.  
  993.  
  994. TWM(1)                               TWM(1)
  995.  
  996.  
  997.        RRaannddoommPPllaacceemmeenntt
  998.            This variable indicates that windows with no spec-
  999.            ified geometry should be placed in a pseudo-random
  1000.            location     instead  of  having the user drag out an
  1001.            outline.
  1002.  
  1003.        RReessiizzeeFFoonntt _s_t_r_i_n_g
  1004.            This variable specifies the font to be used for in
  1005.            the  dimensions window when resizing windows.  The
  1006.            default is "fixed".
  1007.  
  1008.        RReessttaarrttPPrreevviioouussSSttaattee
  1009.            This variable indicates that _t_w_m should attempt to
  1010.            use  the     WM_STATE  property  on client windows to
  1011.            tell which windows should be iconified  and  which
  1012.            should be left visible.    This is typically used to
  1013.            try to regenerate the state that the screen was in
  1014.            before the previous window manager was shutdown.
  1015.  
  1016.        SSaavveeCCoolloorr { _c_o_l_o_r_s_-_l_i_s_t }
  1017.            This  variable  indicates  a list of color assign-
  1018.            ments to be stored as pixel  values  in    the  root
  1019.            window property _MIT_PRIORITY_COLORS.  Clients may
  1020.            elect to preserve  these     values     when  installing
  1021.            their  own colormap.  Note that use of this mecha-
  1022.            nism is a way an     for  application  to  avoid  the
  1023.            "technicolor"   problem,      whereby  useful  screen
  1024.            objects such as window borders and titlebars  dis-
  1025.            appear when a programs custom colors are installed
  1026.            by the window manager.  For example:
  1027.  
  1028.             SSaavveeCCoolloorr
  1029.             {
  1030.                 BorderColor
  1031.                 TitleBackground
  1032.                 TitleForeground
  1033.                 "red"
  1034.                 "green"
  1035.                 "blue"
  1036.             }
  1037.  
  1038.            This would place on the root window 3 pixel values
  1039.            for  borders  and  titlebars, as well as the three
  1040.            color strings, all taken     from  the  default  col-
  1041.            ormap.
  1042.  
  1043.        SShhoowwIIccoonnMMaannaaggeerr
  1044.            This variable indicates that the icon manager win-
  1045.            dow should be displayed when _t_w_m is  started.   It
  1046.            can  always  be brought up using the ff..sshhoowwiiccoonnmmggrr
  1047.            function.
  1048.  
  1049.        SSoorrttIIccoonnMMaannaaggeerr
  1050.            This variable indicates that entries in    the  icon
  1051.  
  1052.  
  1053.  
  1054. X Version 11           Release 6.1                   16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. TWM(1)                               TWM(1)
  1061.  
  1062.  
  1063.            manager    should    be  sorted  alphabetically rather
  1064.            than by simply appending new windows to the end.
  1065.  
  1066.        SSqquueeeezzeeTTiittllee [{ _s_q_u_e_e_z_e_-_l_i_s_t }]
  1067.            This variable indicates that _t_w_m should attempt to
  1068.            use  the     SHAPE extension to make titlebars occupy
  1069.            only as much screen space  as  they  need,  rather
  1070.            than  extending    all the way across the top of the
  1071.            window.    The optional _s_q_u_e_e_z_e_-_l_i_s_t may be used  to
  1072.            control    the  location  of  the    squeezed titlebar
  1073.            along the top of the window.  It contains  entries
  1074.            of the form:
  1075.  
  1076.              "_n_a_m_e"        _j_u_s_t_i_f_i_c_a_t_i_o_n  _n_u_m  _d_e_n_o_m
  1077.  
  1078.            where  _n_a_m_e  is    a  window  name, _j_u_s_t_i_f_i_c_a_t_i_o_n is
  1079.            either lleefftt, cceenntteerr, or rriigghhtt, and _n_u_m  and  _d_e_n_o_m
  1080.            are numbers specifying a ratio giving the relative
  1081.            position about which the     titlebar  is  justified.
  1082.            The  ratio  is  measured from left to right if the
  1083.            numerator is positive, and right to left if  nega-
  1084.            tive.   A  denominator  of  0  indicates     that the
  1085.            numerator should be measured in pixels.    For  con-
  1086.            venience,  the  ratio  0/0  is the same as 1/2 for
  1087.            cceenntteerr and -1/1 for rriigghhtt.  For example:
  1088.  
  1089.             SSqquueeeezzeeTTiittllee
  1090.             {
  1091.              "XTerm"   left         0      0
  1092.              "xterm1"  left         1      3
  1093.              "xterm2"  left         2      3
  1094.              "oclock"  center      0    0
  1095.              "emacs"   right      0    0
  1096.             }
  1097.  
  1098.            The DDoonnttSSqquueeeezzeeTTiittllee list can be used to turn  off
  1099.            squeezing on certain titles.
  1100.  
  1101.        SSttaarrttIIccoonniiffiieedd [{ _w_i_n_-_l_i_s_t }]
  1102.            This variable indicates that client windows should
  1103.            initially  be  left  as    icons  until   explicitly
  1104.            deiconified by the user.     If the optional _w_i_n_-_l_i_s_t
  1105.            is given,  only    those  windows    will  be  started
  1106.            iconic.     This  is useful for programs that do not
  1107.            support    an  _-_i_c_o_n_i_c  command   line   option   or
  1108.            resource.
  1109.  
  1110.        TTiittlleeBBaacckkggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  1111.            This  variable specifies the background color used
  1112.            in titlebars, and may only be specified inside  of
  1113.            a   CCoolloorr,  GGrraayyssccaallee  or  MMoonnoocchhrroommee  list.   The
  1114.            optional _w_i_n_-_l_i_s_t is a list of  window  names  and
  1115.            colors so that per-window colors may be specified.
  1116.            The default is "white".
  1117.  
  1118.  
  1119.  
  1120. X Version 11           Release 6.1                   17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. TWM(1)                               TWM(1)
  1127.  
  1128.  
  1129.        TTiittlleeBBuuttttoonnBBoorrddeerrWWiiddtthh _p_i_x_e_l_s
  1130.            This variable specifies the width in pixels of the
  1131.            border  surrounding  titlebuttons.   This is typi-
  1132.            cally set to 0 to allow titlebuttons to take up as
  1133.            much  space  as possible and to not have a border.
  1134.            The default is 1.
  1135.  
  1136.        TTiittlleeFFoonntt _s_t_r_i_n_g
  1137.            This variable specifies the font to  be    used  for
  1138.            displaying window names in titlebars.  The default
  1139.            is "variable".
  1140.  
  1141.        TTiittlleeFFoorreeggrroouunndd _s_t_r_i_n_g [{ _w_i_n_-_l_i_s_t }]
  1142.            This variable specifies the foreground color  used
  1143.            in  titlebars, and may only be specified inside of
  1144.            a  CCoolloorr,  GGrraayyssccaallee  or     MMoonnoocchhrroommee  list.    The
  1145.            optional     _w_i_n_-_l_i_s_t  is  a list of window names and
  1146.            colors so that per-window colors may be specified.
  1147.            The default is "black".
  1148.  
  1149.        TTiittlleePPaaddddiinngg _p_i_x_e_l_s
  1150.            This  variable  specifies the distance between the
  1151.            various buttons, text, and highlight areas in  the
  1152.            titlebar.  The default is 8 pixels.
  1153.  
  1154.        UUnnkknnoowwnnIIccoonn _s_t_r_i_n_g
  1155.            This  variable  specifies the filename of a bitmap
  1156.            file to be used as the default icon.  This  bitmap
  1157.            will  be     used as the icon of all clients which do
  1158.            not provide an icon bitmap and are not  listed  in
  1159.            the IIccoonnss list.
  1160.  
  1161.        UUsseePPPPoossiittiioonn _s_t_r_i_n_g
  1162.            This  variable specifies whether or not _t_w_m should
  1163.            honor program-requested locations  (given  by  the
  1164.            PPPPoossiittiioonn flag in the WM_NORMAL_HINTS property) in
  1165.            the absence of  a  user-specified  position.   The
  1166.            argument     _s_t_r_i_n_g     may  have  one     of three values:
  1167.            ""ooffff"" (the default)  indicating    that  _t_w_m  should
  1168.            ignore  the  program-supplied position, ""oonn"" indi-
  1169.            cating that the position should be used, and ""nnoonn--
  1170.            zzeerroo""  indicating that the position should used if
  1171.            it is other than (0,0).    The latter option is  for
  1172.            working around a bug in older toolkits.
  1173.  
  1174.        WWaarrppCCuurrssoorr [{ _w_i_n_-_l_i_s_t }]
  1175.            This variable indicates that the pointer should be
  1176.            warped into windows when they are deiconified.  If
  1177.            the  optional  _w_i_n_-_l_i_s_t is given, the pointer will
  1178.            only be warped when those windows are deiconified.
  1179.  
  1180.        WWiinnddoowwRRiinngg { _w_i_n_-_l_i_s_t }
  1181.            This  variable  specifies  a list of windows along
  1182.            which the ff..wwaarrpprriinngg function cycles.
  1183.  
  1184.  
  1185.  
  1186. X Version 11           Release 6.1                   18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. TWM(1)                               TWM(1)
  1193.  
  1194.  
  1195.        WWaarrppUUnnmmaappppeedd
  1196.            This variable indicates that the ff..wwaarrppttoo function
  1197.            should  deiconify any iconified windows it encoun-
  1198.            ters.  This is typically used to make a key  bind-
  1199.            ing  that  will    pop  a particular window (such as
  1200.            _x_m_h), no matter where it is.  The default  is  for
  1201.            ff..wwaarrppttoo to ignore iconified windows.
  1202.  
  1203.        XXoorrVVaalluuee _n_u_m_b_e_r
  1204.            This  variable  specifies  the  value  to use when
  1205.            drawing window outlines for moving  and    resizing.
  1206.            This  should be set to a value that will result in
  1207.            a variety of of distinguishable colors when exclu-
  1208.            sive-or'ed with the contents of the user's typical
  1209.            screen.    Setting this variable to  1  often  gives
  1210.            nice  results  if  adjacent  colors in the default
  1211.            colormap     are  distinct.      By  default,    _t_w_m  will
  1212.            attempt    to cause temporary lines to appear at the
  1213.            opposite end of the colormap from the graphics.
  1214.  
  1215.        ZZoooomm [ _c_o_u_n_t ]
  1216.            This variable indicates that  outlines  suggesting
  1217.            movement     of  a    window    to and from its iconified
  1218.            state should be displayed  whenever  a  window  is
  1219.            iconified  or  deiconified.   The  optional  _c_o_u_n_t
  1220.            argument specifies the number of     outlines  to  be
  1221.            drawn.  The default count is 8.
  1222.  
  1223.        The  following  variables must be set after the fonts have
  1224.        been assigned, so it is usually best to put  them  at  the
  1225.        end  of    the  variables    or beginning of the bindings sec-
  1226.        tions:
  1227.  
  1228.        DDeeffaauullttFFuunnccttiioonn _f_u_n_c_t_i_o_n
  1229.            This variable specifies the function  to     be  exe-
  1230.            cuted  when  a key or button event is received for
  1231.            which no binding is provided.  This  is    typically
  1232.            bound  to ff..nnoopp, ff..bbeeeepp, or a menu containing win-
  1233.            dow operations.
  1234.  
  1235.        WWiinnddoowwFFuunnccttiioonn _f_u_n_c_t_i_o_n
  1236.            This variable specifies the  function  to  execute
  1237.            when  a    window    is  selected  from the TTwwmmWWiinnddoowwss
  1238.            menu.  If this variable is  not    set,  the  window
  1239.            will be deiconified and raised.
  1240.  
  1241. BBIINNDDIINNGGSS
  1242.        After  the  desired variables have been set, functions may
  1243.        be attached titlebuttons     and  key  and    pointer     buttons.
  1244.        Titlebuttons  may be added from the left or right side and
  1245.        appear in the titlebar from left-to-right according to the
  1246.        order in which they are specified.  Key and pointer button
  1247.        bindings may be given in any order.
  1248.  
  1249.  
  1250.  
  1251.  
  1252. X Version 11           Release 6.1                   19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. TWM(1)                               TWM(1)
  1259.  
  1260.  
  1261.        Titlebuttons specifications must include the name  of  the
  1262.        pixmap  to  use    in  the button box and the function to be
  1263.        invoked when a pointer button is pressed within them:
  1264.  
  1265.         LLeeffttTTiittlleeBBuuttttoonn "_b_i_t_m_a_p_n_a_m_e"  = _f_u_n_c_t_i_o_n
  1266.  
  1267.        or
  1268.  
  1269.         RRiigghhttTTiittlleeBBuuttttoonn "_b_i_t_m_a_p_n_a_m_e" = _f_u_n_c_t_i_o_n
  1270.  
  1271.        The _b_i_t_m_a_p_n_a_m_e may refer to one of the    built-in  bitmaps
  1272.        (which  are scaled to match TTiittlleeFFoonntt) by using the appro-
  1273.        priate colon-prefixed name described above.
  1274.  
  1275.        Key and pointer button specifications must give the  modi-
  1276.        fiers that must be pressed, over which parts of the screen
  1277.        the pointer must be, and what function is to  be     invoked.
  1278.        Keys  are  given     as  strings  containing  the appropriate
  1279.        keysym name;  buttons  are  given  as  the  keywords  BBuutt--
  1280.        ttoonn11-BBuuttttoonn55:
  1281.  
  1282.         "FP1"       = _m_o_d_l_i_s_t : _c_o_n_t_e_x_t : _f_u_n_c_t_i_o_n
  1283.         BBuuttttoonn11   = _m_o_d_l_i_s_t : _c_o_n_t_e_x_t : _f_u_n_c_t_i_o_n
  1284.  
  1285.        The  _m_o_d_l_i_s_t  is     any  combination  of  the modifier names
  1286.        sshhiifftt, ccoonnttrrooll, lloocckk, mmeettaa, mmoodd11,  mmoodd22,     mmoodd33,    mmoodd44,  or
  1287.        mmoodd55  (which may be abbreviated as ss, cc, ll, mm, mm11, mm22, mm33,
  1288.        mm44, mm55, respectively) separated by  a  vertical    bar  (|).
  1289.        Similarly,  the    _c_o_n_t_e_x_t     is  any  combination  of wwiinnddooww,
  1290.        ttiittllee, iiccoonn, rroooott, ffrraammee,  iiccoonnmmggrr,  their  first  letters
  1291.        (iiccoonnmmggrr abbreviation is mm), or aallll, separated by a verti-
  1292.        cal  bar.   The    _f_u_n_c_t_i_o_n  is  any  of  the  ff..     keywords
  1293.        described  below.   For    example, the default startup file
  1294.        contains the following bindings:
  1295.  
  1296.         Button1   =       : root      : f.menu "TwmWindows"
  1297.         Button1   = m  : window | icon     : f.function "move-or-lower"
  1298.         Button2   = m  : window | icon     : f.iconify
  1299.         Button3   = m  : window | icon     : f.function "move-or-raise"
  1300.         Button1   =       : title      : f.function "move-or-raise"
  1301.         Button2   =       : title      : f.raiselower
  1302.         Button1   =       : icon      : f.function "move-or-iconify"
  1303.         Button2   =       : icon      : f.iconify
  1304.         Button1   =       : iconmgr : f.iconify
  1305.         Button2   =       : iconmgr : f.iconify
  1306.  
  1307.        A user who wanted to be able to    manipulate  windows  from
  1308.        the keyboard could use the following bindings:
  1309.  
  1310.         "F1" =    : all         : f.iconify
  1311.         "F2" =    : all         : f.raiselower
  1312.         "F3" =    : all         : f.warpring "next"
  1313.         "F4" =    : all         : f.warpto "xmh"
  1314.         "F5" =    : all         : f.warpto "emacs"
  1315.  
  1316.  
  1317.  
  1318. X Version 11           Release 6.1                   20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. TWM(1)                               TWM(1)
  1325.  
  1326.  
  1327.         "F6" =    : all         : f.colormap "next"
  1328.         "F7" =    : all         : f.colormap "default"
  1329.         "F20"     =       : all      : f.warptoscreen "next"
  1330.         "Left"    = m  : all      : f.backiconmgr
  1331.         "Right"   = m | s    : all           : f.forwiconmgr
  1332.         "Up" = m  : all         : f.upiconmgr
  1333.         "Down"    = m | s    : all           : f.downiconmgr
  1334.  
  1335.        _T_w_m provides many more window manipulation primitives than
  1336.        can be conveniently stored in a titlebar, menu, or set  of
  1337.        key  bindings.    Although a small set of defaults are sup-
  1338.        plied (unless the NNooDDeeffaauullttss  is     specified),  most  users
  1339.        will  want  to  have their most common operations bound to
  1340.        key and button strokes.    To do this, _t_w_m associates  names
  1341.        with  each  of  the  primitives    and provides _u_s_e_r_-_d_e_f_i_n_e_d
  1342.        _f_u_n_c_t_i_o_n_s for building higher level primitives  and  _m_e_n_u_s
  1343.        for interactively selecting among groups of functions.
  1344.  
  1345.        User-defined  functions contain the name by which they are
  1346.        referenced in calls to ff..ffuunnccttiioonn  and  a  list    of  other
  1347.        functions to execute.  For example:
  1348.  
  1349.         Function "move-or-lower" { f.move f.deltastop f.lower }
  1350.         Function "move-or-raise" { f.move f.deltastop f.raise }
  1351.         Function "move-or-iconify"      { f.move f.deltastop f.iconify }
  1352.         Function "restore-colormap"      { f.colormap "default" f.lower }
  1353.  
  1354.        The function name must be used in ff..ffuunnccttiioonn exactly as it
  1355.        appears in the function specification.
  1356.  
  1357.        In the descriptions below, if  the  function  is     said  to
  1358.        operate on the selected window, but is invoked from a root
  1359.        menu, the cursor will be changed to the SSeelleecctt cursor  and
  1360.        the next window to receive a button press will be chosen:
  1361.  
  1362.        !! _s_t_r_i_n_g
  1363.            This is an abbreviation for ff..eexxeecc _s_t_r_i_n_g.
  1364.  
  1365.        ff..aauuttoorraaiissee
  1366.            This  function toggles whether or not the selected
  1367.            window is raised whenever entered by the     pointer.
  1368.            See the description of the variable AAuuttooRRaaiissee.
  1369.  
  1370.        ff..bbaacckkiiccoonnmmggrr
  1371.            This  function  warps  the pointer to the previous
  1372.            column in the current icon manager, wrapping  back
  1373.            to the previous row if necessary.
  1374.  
  1375.        ff..bbeeeepp  This function sounds the keyboard bell.
  1376.  
  1377.        ff..bboottttoommzzoooomm
  1378.            This  function  is similar to the ff..ffuullllzzoooomm func-
  1379.            tion, but resizes the window to fill only the bot-
  1380.            tom half of the screen.
  1381.  
  1382.  
  1383.  
  1384. X Version 11           Release 6.1                   21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. TWM(1)                               TWM(1)
  1391.  
  1392.  
  1393.        ff..cciirrcclleeddoowwnn
  1394.            This  function  lowers  the  top-most  window that
  1395.            occludes another window.
  1396.  
  1397.        ff..cciirrcclleeuupp
  1398.            This function raises the bottom-most  window  that
  1399.            is occluded by another window.
  1400.  
  1401.        ff..ccoolloorrmmaapp _s_t_r_i_n_g
  1402.            This function rotates the colormaps (obtained from
  1403.            the WM_COLORMAP_WINDOWS property     on  the  window)
  1404.            that  _t_w_m will display when the pointer is in this
  1405.            window.    The argument _s_t_r_i_n_g may have one  of  the
  1406.            following  values:  ""nneexxtt"", ""pprreevv"", and ""ddeeffaauulltt"".
  1407.            It should be  noted  here  that    in  general,  the
  1408.            installed   colormap  is     determined  by     keyboard
  1409.            focus.    A  pointer  driven  keyboard  focus  will
  1410.            install    a private colormap upon entry of the win-
  1411.            dow owning the colormap.     Using the click to  type
  1412.            model,  private    colormaps  will     not be installed
  1413.            until the user presses a mouse button on the  tar-
  1414.            get window.
  1415.  
  1416.        ff..ddeeiiccoonniiffyy
  1417.            This function deiconifies the selected window.  If
  1418.            the window is not  an  icon,  this  function  does
  1419.            nothing.
  1420.  
  1421.        ff..ddeelleettee
  1422.            This  function  sends the WM_DELETE_WINDOW message
  1423.            to the selected window if the  client  application
  1424.            has  requested  it through the WM_PROTOCOLS window
  1425.            property.  The application is supposed to  respond
  1426.            to  the    message by removing the indicated window.
  1427.            If the window has not  requested     WM_DELETE_WINDOW
  1428.            messages,  the keyboard bell will be rung indicat-
  1429.            ing that the user  should  choose  an  alternative
  1430.            method.      Note     this    is  very  different  from
  1431.            f.destroy.  The intent here is to delete a  single
  1432.            window,    not necessarily the entire application.
  1433.  
  1434.        ff..ddeellttaassttoopp
  1435.            This function allows a user-defined function to be
  1436.            aborted if the pointer has been    moved  more  than
  1437.            _M_o_v_e_D_e_l_t_a  pixels.   See     the  example  definition
  1438.            given for FFuunnccttiioonn ""mmoovvee--oorr--rraaiissee"" at  the  begin-
  1439.            ning of the section.
  1440.  
  1441.        ff..ddeessttrrooyy
  1442.            This  function instructs the X server to close the
  1443.            display connection of the client that created  the
  1444.            selected     window.   This     should only be used as a
  1445.            last resort for    shutting  down    runaway     clients.
  1446.            See also f.delete.
  1447.  
  1448.  
  1449.  
  1450. X Version 11           Release 6.1                   22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. TWM(1)                               TWM(1)
  1457.  
  1458.  
  1459.        ff..ddoowwnniiccoonnmmggrr
  1460.            This function warps the pointer to the next row in
  1461.            the current icon manger, wrapping to the beginning
  1462.            of the next column if necessary.
  1463.  
  1464.        ff..eexxeecc _s_t_r_i_n_g
  1465.            This   function    passes    the  argument  _s_t_r_i_n_g  to
  1466.            /bin/sh for execution.  In  multiscreen    mode,  if
  1467.            _s_t_r_i_n_g starts a new X client without giving a dis-
  1468.            play argument,  the  client  will  appear  on  the
  1469.            screen from which this function was invoked.
  1470.  
  1471.        ff..ffooccuuss This  function  toggles    the keyboard focus of the
  1472.            server to the selected window, changing the  focus
  1473.            rule  from  pointer-driven  if  necessary.  If the
  1474.            selected window already was focused, this function
  1475.            executes an ff..uunnffooccuuss.
  1476.  
  1477.        ff..ffoorrcceemmoovvee
  1478.            This  function  is  like     ff..mmoovvee     except     that  it
  1479.            ignores the DDoonnttMMoovveeOOffff variable.
  1480.  
  1481.        ff..ffoorrwwiiccoonnmmggrr
  1482.            This function warps the pointer to the next column
  1483.            in  the    current     icon  manager,     wrapping  to the
  1484.            beginning of the next row if necessary.
  1485.  
  1486.        ff..ffuullllzzoooomm
  1487.            This function resizes the selected window  to  the
  1488.            full  size  of  the  display  or else restores the
  1489.            original size if the window was already zoomed.
  1490.  
  1491.        ff..ffuunnccttiioonn _s_t_r_i_n_g
  1492.            This function executes the  user-defined     function
  1493.            whose name is specified by the argument _s_t_r_i_n_g.
  1494.  
  1495.        ff..hhbbzzoooomm
  1496.            This function is a synonym for ff..bboottttoommzzoooomm.
  1497.  
  1498.        ff..hhiiddeeiiccoonnmmggrr
  1499.            This function unmaps the current icon manager.
  1500.  
  1501.        ff..hhoorriizzoooomm
  1502.            This  variable  is  similar to the ff..zzoooomm function
  1503.            except that the selected window is resized to  the
  1504.            full width of the display.
  1505.  
  1506.        ff..hhttzzoooomm
  1507.            This function is a synonym for ff..ttooppzzoooomm.
  1508.  
  1509.        ff..hhzzoooomm This function is a synonym for ff..hhoorriizzoooomm.
  1510.  
  1511.        ff..iiccoonniiffyy
  1512.            This   function     iconifies   or     deiconifies  the
  1513.  
  1514.  
  1515.  
  1516. X Version 11           Release 6.1                   23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. TWM(1)                               TWM(1)
  1523.  
  1524.  
  1525.            selected window or icon, respectively.
  1526.  
  1527.        ff..iiddeennttiiffyy
  1528.            This function displays a summary of the    name  and
  1529.            geometry     of  the  selected window.  If the server
  1530.            supports the SYNC extension, the priority  of  the
  1531.            client    owning    the  window  is     also  displayed.
  1532.            Clicking the pointer or pressing a key in the win-
  1533.            dow will dismiss it.
  1534.  
  1535.        ff..lleeffttiiccoonnmmggrr
  1536.            This function similar to ff..bbaacckkiiccoonnmmggrr except that
  1537.            wrapping does not change rows.
  1538.  
  1539.        ff..lleeffttzzoooomm
  1540.            This variable is similar to the ff..bboottttoommzzoooomm func-
  1541.            tion  but  causes  the  selected     window     is  only
  1542.            resized to the left half of the display.
  1543.  
  1544.        ff..lloowweerr This function lowers the selected window.
  1545.  
  1546.        ff..mmeennuu _s_t_r_i_n_g
  1547.            This function invokes the menu  specified  by  the
  1548.            argument     _s_t_r_i_n_g.   Cascaded menus may be built by
  1549.            nesting calls to ff..mmeennuu.
  1550.  
  1551.        ff..mmoovvee  This function drags an  outline    of  the     selected
  1552.            window  (or  the     window     itself if the OOppaaqquueeMMoovvee
  1553.            variable is set) until the invoking pointer button
  1554.            is released.  Double clicking within the number of
  1555.            milliseconds given  by  CCoonnssttrraaiinneeddMMoovveeTTiimmee  warps
  1556.            the  pointer  to the center of the window and con-
  1557.            strains the move to be either horizontal or verti-
  1558.            cal  depending  on which grid line is crossed.  To
  1559.            abort a move, press another button before  releas-
  1560.            ing the first button.
  1561.  
  1562.        ff..nneexxttiiccoonnmmggrr
  1563.            This  function  warps the pointer to the next icon
  1564.            manager containing any windows on the  current  or
  1565.            any succeeding screen.
  1566.  
  1567.        ff..nnoopp   This  function  does nothing and is typically used
  1568.            with the DDeeffaauullttFFuunnccttiioonn or  WWiinnddoowwFFuunnccttiioonn  vari-
  1569.            ables or to introduce blank lines in menus.
  1570.  
  1571.        ff..pprreevviiccoonnmmggrr
  1572.            This  function  warps  the pointer to the previous
  1573.            icon manager containing any windows on the current
  1574.            or preceding screens.
  1575.  
  1576.        ff..pprriioorriittyy _s_t_r_i_n_g
  1577.            This function sets the priority of the client own-
  1578.            ing the selected window to the  numeric    value  of
  1579.  
  1580.  
  1581.  
  1582. X Version 11           Release 6.1                   24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588. TWM(1)                               TWM(1)
  1589.  
  1590.  
  1591.            the  argument  _s_t_r_i_n_g,  which  should  be a signed
  1592.            integer in double  quotes  (e.g.     "999"    ).   This
  1593.            function has an effect only if the server supports
  1594.            the SYNC extension.
  1595.  
  1596.        ff..qquuiitt  This function causes _t_w_m to restore  the     window's
  1597.            borders    and  exit.   If     _t_w_m  is the first client
  1598.            invoked from _x_d_m, this will  result  in    a  server
  1599.            reset.
  1600.  
  1601.        ff..rraaiissee This function raises the selected window.
  1602.  
  1603.        ff..rraaiisseelloowweerr
  1604.            This  function  raises  the selected window to the
  1605.            top of the stacking order if it is occluded by any
  1606.            windows, otherwise the window will be lowered.
  1607.  
  1608.        ff..rreeffrreesshh
  1609.            This  function causes all windows to be refreshed.
  1610.  
  1611.        ff..rreessiizzee
  1612.            This function displays an outline of the     selected
  1613.            window.     Crossing  a border (or setting AAuuttooRReellaa--
  1614.            ttiivveeRReessiizzee) will cause the  outline  to    begin  to
  1615.            rubber band until the invoking button is released.
  1616.            To abort a resize,  press  another  button  before
  1617.            releasing the first button.
  1618.  
  1619.        ff..rreessttaarrtt
  1620.  
  1621.            This function kills and restarts _t_w_m.
  1622.  
  1623.        ff..rriigghhttiiccoonnmmggrr
  1624.            This  function  is similar to ff..nneexxttiiccoonnmmggrr except
  1625.            that wrapping does not change rows.
  1626.  
  1627.        ff..rriigghhttzzoooomm
  1628.            This variable is similar to the ff..bboottttoommzzoooomm func-
  1629.            tion  except  that  the    selected  window  is only
  1630.            resized to the right half of the display.
  1631.  
  1632.        ff..ssaavveeyyoouurrsseellff
  1633.            This function sends a WM_SAVEYOURSELF  message  to
  1634.            the  selected  window if it has requested the mes-
  1635.            sage in its WM_PROTOCOLS window property.  Clients
  1636.            that  accept  this  message are supposed to check-
  1637.            point all state associated  with     the  window  and
  1638.            update the WM_COMMAND property as specified in the
  1639.            ICCCM.  If the selected window  has  not     selected
  1640.            for  this message, the keyboard bell will be rung.
  1641.  
  1642.        ff..sshhoowwiiccoonnmmggrr
  1643.            This function maps the current icon manager.
  1644.  
  1645.  
  1646.  
  1647.  
  1648. X Version 11           Release 6.1                   25
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. TWM(1)                               TWM(1)
  1655.  
  1656.  
  1657.        ff..ssoorrttiiccoonnmmggrr
  1658.            This function sorts the    entries     in  the  current
  1659.            icon  manager  alphabetically.    See  the variable
  1660.            SSoorrttIIccoonnMMaannaaggeerr.
  1661.  
  1662.        ff..ttiittllee This function provides  a  centered,  unselectable
  1663.            item  in a menu definition.  It should not be used
  1664.            in any other context.
  1665.  
  1666.        ff..ttooppzzoooomm
  1667.            This variable is similar to the ff..bboottttoommzzoooomm func-
  1668.            tion  except  that  the    selected  window  is only
  1669.            resized to the top half of the display.
  1670.  
  1671.        ff..uunnffooccuuss
  1672.            This function resets the focus  back  to     pointer-
  1673.            driven.    This should be used when a focused window
  1674.            is no longer desired.
  1675.  
  1676.        ff..uuppiiccoonnmmggrr
  1677.            This function warps the pointer    to  the     previous
  1678.            row  in    the current icon manager, wrapping to the
  1679.            last row in the same column if necessary.
  1680.  
  1681.        ff..vvllzzoooomm
  1682.            This function is a synonym for ff..lleeffttzzoooomm.
  1683.  
  1684.        ff..vvrrzzoooomm
  1685.            This function is a synonym for ff..rriigghhttzzoooomm.
  1686.  
  1687.        ff..wwaarrpprriinngg _s_t_r_i_n_g
  1688.            This function warps the pointer    to  the     next  or
  1689.            previous     window     (as  indicated     by  the argument
  1690.            _s_t_r_i_n_g, which may be ""nneexxtt"" or  ""pprreevv"")    specified
  1691.            in the WWiinnddoowwRRiinngg variable.
  1692.  
  1693.        ff..wwaarrppttoo _s_t_r_i_n_g
  1694.            This  function  warps  the  pointer  to the window
  1695.            which has a name or class that matches _s_t_r_i_n_g.  If
  1696.            the window is iconified, it will be deiconified if
  1697.            the variable WWaarrppUUnnmmaappppeedd is set or else     ignored.
  1698.  
  1699.        ff..wwaarrppttooiiccoonnmmggrr _s_t_r_i_n_g
  1700.            This  function  warps the pointer to the icon man-
  1701.            ager entry associated with the  window  containing
  1702.            the  pointer  in the icon manager specified by the
  1703.            argument _s_t_r_i_n_g.     If _s_t_r_i_n_g is  empty  (i.e.  ""),
  1704.            the current icon manager is chosen.
  1705.  
  1706.        ff..wwaarrppttoossccrreeeenn _s_t_r_i_n_g
  1707.            This  function  warps  the  pointer  to the screen
  1708.            specified by the argument _s_t_r_i_n_g.  _S_t_r_i_n_g may be a
  1709.            number  (e.g.  ""00"" or ""11""), the word ""nneexxtt"" (indi-
  1710.            cating the current screen plus  1,  skipping  over
  1711.  
  1712.  
  1713.  
  1714. X Version 11           Release 6.1                   26
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720. TWM(1)                               TWM(1)
  1721.  
  1722.  
  1723.            any  unmanaged screens), the word ""bbaacckk"" (indicat-
  1724.            ing the current screen minus 1, skipping over  any
  1725.            unmanaged screens), or the word ""pprreevv"" (indicating
  1726.            the last screen visited.
  1727.  
  1728.        ff..wwiinnrreeffrreesshh
  1729.            This function is similar to the ff..rreeffrreesshh function
  1730.            except that only the selected window is refreshed.
  1731.  
  1732.        ff..zzoooomm  This function is similar to the    ff..ffuullllzzoooomm  func-
  1733.            tion,  except  that  the     only  the  height of the
  1734.            selected window is changed.
  1735.  
  1736. MMEENNUUSS
  1737.        Functions may be grouped and interactively selected  using
  1738.        pop-up (when bound to a pointer button) or pull-down (when
  1739.        associated with a titlebutton) menus.  Each menu     specifi-
  1740.        cation  contains     the  name  of    the  menu  as  it will be
  1741.        referred to by ff..mmeennuu,  optional     default  foreground  and
  1742.        background  colors,  the     list of item names and the func-
  1743.        tions they should  invoke,  and    optional  foreground  and
  1744.        background colors for individual items:
  1745.  
  1746.         MMeennuu "_m_e_n_u_n_a_m_e" [ ("_d_e_f_f_o_r_e":"_d_e_f_b_a_c_k") ]
  1747.         {
  1748.          _s_t_r_i_n_g_1   [ ("_f_o_r_e_1":"_b_a_c_k_n")]        _f_u_n_c_t_i_o_n_1
  1749.          _s_t_r_i_n_g_2   [ ("_f_o_r_e_2":"_b_a_c_k_n")]        _f_u_n_c_t_i_o_n_2
  1750.               .
  1751.               .
  1752.               .
  1753.          _s_t_r_i_n_g_N   [ ("_f_o_r_e_N":"_b_a_c_k_N")]        _f_u_n_c_t_i_o_n_N
  1754.         }
  1755.  
  1756.  
  1757.        The  _m_e_n_u_n_a_m_e is case-sensitive.     The optional _d_e_f_f_o_r_e and
  1758.        _d_e_f_b_a_c_k arguments specify the  foreground  and  background
  1759.        colors  used on a color display to highlight menu entries.
  1760.        The _s_t_r_i_n_g portion of each menu entry  will  be    the  text
  1761.        which will appear in the menu.  The optional _f_o_r_e and _b_a_c_k
  1762.        arguments specify the foreground and background colors  of
  1763.        the  menu  entry     when  the  pointer  is not in the entry.
  1764.        These colors will only be used on a  color  display.   The
  1765.        default    is  to    use the colors specified by the MMeennuuFFoorree--
  1766.        ggrroouunndd and MMeennuuBBaacckkggrroouunndd variables.  The _f_u_n_c_t_i_o_n portion
  1767.        of  the    menu entry is one of the functions, including any
  1768.        user-defined functions, or additional menus.
  1769.  
  1770.        There is a special menu named  TTwwmmWWiinnddoowwss  which     contains
  1771.        the  names  of all of the client and _t_w_m-supplied windows.
  1772.        Selecting an entry will cause  the  WWiinnddoowwFFuunnccttiioonn  to  be
  1773.        executed     on  that  window.  If WWiinnddoowwFFuunnccttiioonn hasn't been
  1774.        set, the window will be deiconified and raised.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780. X Version 11           Release 6.1                   27
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786. TWM(1)                               TWM(1)
  1787.  
  1788.  
  1789. IICCOONNSS
  1790.        _T_w_m supports several different ways of manipulating iconi-
  1791.        fied  windows.    The  common  pixmap-and-text style may be
  1792.        laid out by hand or automatically arranged as described by
  1793.        the  IIccoonnRReeggiioonn    variable.   In    addition, a terse grid of
  1794.        icon names, called an icon manager, provides a more  effi-
  1795.        cient  use of screen space as well as the ability to navi-
  1796.        gate among windows from the keyboard.
  1797.  
  1798.        An icon    manager     is  a    window    that  contains    names  of
  1799.        selected     or  all  windows  currently  on the display.  In
  1800.        addition to the window name,  a    small  button  using  the
  1801.        default    iconify     symbol     will be displayed to the left of
  1802.        the name when the window is iconified.  By default, click-
  1803.        ing  on    an  entry in the icon manager performs ff..iiccoonniiffyy.
  1804.        To change the actions taken in the icon manager,     use  the
  1805.        the  iiccoonnmmggrr  context  when specifying button and keyboard
  1806.        bindings.
  1807.  
  1808.        Moving the pointer into the icon manager also directs key-
  1809.        board  focus  to     the  indicated window (setting the focus
  1810.        explicitly or else sending synthetic  events  NNooTTiittlleeFFooccuuss
  1811.        is    set).     Using   the   ff..uuppiiccoonnmmggrr,   ff..ddoowwnniiccoonnmmggrr
  1812.        ff..lleeffttiiccoonnmmggrr, and  ff..rriigghhttiiccoonnmmggrr  functions,  the  input
  1813.        focus  can  be  changed    between windows directly from the
  1814.        keyboard.
  1815.  
  1816. BBUUGGSS
  1817.        The resource manager should have been used instead of  all
  1818.        of the window lists.
  1819.  
  1820.        The IIccoonnRReeggiioonn variable should take a list.
  1821.  
  1822.        Double  clicking     very  fast  to     get the constrained move
  1823.        function will sometimes cause the  window  to  move,  even
  1824.        though the pointer is not moved.
  1825.  
  1826.        If  IIccoonniiffyyBByyUUnnmmaappppiinngg  is  on  and  windows are listed in
  1827.        IIccoonnMMaannaaggeerrDDoonnttSShhooww  but     not  in  DDoonnttIIccoonniiffyyBByyUUnnmmaappppiinngg,
  1828.        they  may be lost if they are iconified and no bindings to
  1829.        ff..mmeennuu ""TTwwmmWWiinnddoowwss"" or ff..wwaarrppttoo are setup.
  1830.  
  1831. FFIILLEESS
  1832.     $HOME/.twmrc.<screen number>
  1833.     $HOME/.twmrc
  1834.     <XRoot>/lib/X11/twm/system.twmrc
  1835.  
  1836. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  1837.        DISPLAY This variable is used to determine which X  server
  1838.            to use.    It is also set during ff..eexxeecc so that pro-
  1839.            grams come up on the proper screen.
  1840.  
  1841.        HOME    This variable is used as the prefix for files that
  1842.            begin  with  a  tilde  and  for    locating  the _t_w_m
  1843.  
  1844.  
  1845.  
  1846. X Version 11           Release 6.1                   28
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852. TWM(1)                               TWM(1)
  1853.  
  1854.  
  1855.            startup file.
  1856.  
  1857. SSEEEE AALLSSOO
  1858.        X(1), Xserver(1), xdm(1), xrdb(1)
  1859.  
  1860. AAUUTTHHOORRSS
  1861.        Tom LaStrange, Solbourne Computer; Jim Fulton, MIT X  Con-
  1862.        sortium; Steve Pitschke, Stardent Computer; Keith Packard,
  1863.        MIT X Consortium; Dave Sternlicht, MIT X Consortium;  Dave
  1864.        Payne, Apple Computer.
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912. X Version 11           Release 6.1                   29
  1913.  
  1914.  
  1915.