


olwm(1)                                                   olwm(1)


NNAAMMEE
       olwm - OPEN LOOK window manager for OpenWindows

SSYYNNOOPPSSIISS
       oollwwmm [ _o_p_t_i_o_n_s ]

DDEESSCCRRIIPPTTIIOONN
       OOllwwmm  is  a  window  manager  for the X Window System that
       implements parts of the OPEN LOOK  graphical  user  inter-
       face.   It  is the standard window manager for Sun's Open-
       Windows product, but it will work properly  with  any  X11
       system.   The  only requirements for running oollwwmm are that
       the server have the  OPEN  LOOK  glyph  and  cursor  fonts
       available.

OOPPTTIIOONNSS
       Most   command-line   options  have  counterparts  in  the
       resource database.  A command-line  option  will  override
       any setting from the resource database.

       --22dd    Use  two-dimensional look.  This is the default for
              monochrome systems.

       --33dd    Use three-dimensional look.  This  is  the  default
              for  color  systems.   This  option  is ignored for
              monochrome systems.

       --bbdd _c_o_l_o_r_,  --bboorrddeerrccoolloorr _c_o_l_o_r
              Specifies the border color.  See the description of
              the BBoorrddeerrCCoolloorr resource.

       --bbgg _c_o_l_o_r_,  --bbaacckkggrroouunndd _c_o_l_o_r
              Specifies  the  background color.  See the descrip-
              tion of the BBaacckkggrroouunndd resource.

       --cc,  --cclliicckk
              Use click-to-focus mode.  This is the default focus
              mode.

       --ddeepptthh _d_e_p_t_h
              Specifies  the depth of the visual in which oollwwmm is
              to run.  See the discussion in the Screen Resources
              section for further information about depths.

       --ddiissppllaayy _d_i_s_p_l_a_y_-_s_t_r_i_n_g
              Specify  the  name of the display to manage.  Over-
              rides the DISPLAY environment variable, if any.  In
              addition,  the display string is exported to oollwwmm's
              environment, so processes  forked  from  oollwwmm  will
              inherit this value.

       --ddssddmm  Specify  that  oollwwmm  should  provide  the Drop Site
              Database Management (DSDM) service.   This  is  the
              default.



                           25 Nov 1992                          1





olwm(1)                                                   olwm(1)


       --ff,  --ffoollllooww
              Use  focus-follows-mouse  mode.   Default  mode  is
              click-to-focus.

       --ffnn _f_o_n_t_-_n_a_m_e_,  --ffoonntt  _f_o_n_t_-_n_a_m_e
              Set the font for window titles.

       --ffgg _c_o_l_o_r_,  --ffoorreeggrroouunndd _c_o_l_o_r
              Specifies the foreground color.  See  the  descrip-
              tion of the FFoorreeggrroouunnddCCoolloorr resource.

       --mmuullttii Manage  windows  on all screens that a display sup-
              ports.  This is the default.

       --nnaammee _r_e_s_o_u_r_c_e_-_n_a_m_e
              Use _r_e_s_o_u_r_c_e_-_n_a_m_e  to  look  up  resources  in  the
              resource database.

       --nnooddssddmm
              Specify  that oollwwmm should not provide the Drop Site
              Database Management service.   The  default  is  to
              provide the service.

       --ssiinnggllee
              Manage  windows for a single screen only, using the
              default screen for the  specified  display.   Over-
              rides the --mmuullttii option.

       --ssyynnccppiidd _p_r_o_c_e_s_s_-_i_d
              When oollwwmm has completed its initialization, it will
              send a signal (SIGALRM by default)  to  _p_r_o_c_e_s_s_-_i_d_.
              The signal will be sent only if this option is pre-
              sent.  This is useful for running oollwwmm  from  shell
              scripts  (such  as ..xxiinniittrrcc) in such a way that the
              script waits for oollwwmm to finish its initialization,
              while  leaving oollwwmm as a child process of the shell
              script.  This can be done using the following sshh(1)
              construct:

                   sleep 15 & pid=$!
                   olwm -syncpid $pid &
                   wait $pid


       --ssyynnccssiiggnnaall _s_i_g_n_a_l
              Specifies  the  signal  to send instead of SIGALRM.
              The signal is specified as a number,  not  symboli-
              cally.

       --vviissuuaall _v_i_s_u_a_l_-_c_l_a_s_s
              Specifies  the class of the visual in which oollwwmm is
              to run.  See the discussion in the Screen Resources
              section for further information about visuals.




                           25 Nov 1992                          2





olwm(1)                                                   olwm(1)


       --xxrrmm _r_e_s_o_u_r_c_e_-_s_t_r_i_n_g
              Specify  resources  on the command-line.  Resources
              specified here will  override  resources  found  in
              resource files.

DDEEBBUUGGGGIINNGG OOPPTTIIOONNSS
       The  following  options  are strictly for debugging.  They
       are not recommended  for  general  use.   Don't  use  them
       unless you know what you are doing.

       --aallll   Print a message for every event received.

       --ddeebbuugg Equivalent to turning on all debugging options.

       --oorrpphhaannss
              Print  orphaned events.  Orphaned events are events
              that are associated with a window or frame that has
              no  entry  in  the frame hash table, or events that
              are not handled by the various event handlers.

       --ssyynncchhrroonniizzee
              Run the window manager in synchronous mode.

IINNTTEERRNNAATTIIOONNAALLIIZZAATTIIOONN OOPPTTIIOONNSS
       --bbaassiiccllooccaallee _l_o_c_a_l_e_-_n_a_m_e
              Specifies the basic OPEN LOOK locale category  set-
              ting.   This  category  will  be the base for other
              locale categories.

       --ddiissppllaayyllaanngg _l_o_c_a_l_e_-_n_a_m_e
              Specifies the display  language  OPEN  LOOK  locale
              category.   This  category  affects the contents of
              workspace menu, window menu and notice messages.

       --nnuummeerriicc _l_o_c_a_l_e_-_n_a_m_e
              Specifies the numeric format OPEN LOOK locale cate-
              gory.   This  category  affects  the numeric format
              displayed in any message that contains numerics.

LLOOCCAALLEE HHAANNDDLLIINNGG
       The _l_o_c_a_l_e is the set of language and cultural conventions
       used  by  a  program.   The  locale controls the language-
       dependent part of oollwwmm's behavior.  The OPEN LOOK interna-
       tional  extensions  have defined several locale categories
       as follows:

       BBaassiicc LLooccaallee
              This is the basic setting  for  the  entire  locale
              mechanism.   This category specifies internal char-
              acter handling behavior.

       DDiissppllaayy LLaanngguuaaggee
              This category specifies the language used for  dis-
              playing menus, notice messages, and error messages.



                           25 Nov 1992                          3





olwm(1)                                                   olwm(1)


       IInnppuutt LLaanngguuaaggee
              This category specifies the language used for  text
              input.   This  category  has  no  effect  on  oollwwmm,
              because it does not accept text input from the key-
              board.

       DDaattee FFoorrmmaatt
              This  category  specifies  the  format  of date and
              time.  This category has no effect on oollwwmm, because
              it  does not display any date and time information.

       NNuummeerriicc FFoorrmmaatt
              This category specifies  the  format  of  displayed
              numeric data.

       The Basic Locale setting determines the character set used
       by oollwwmm.  The other locale categories can differ from  the
       basic setting, but they cannot require a different charac-
       ter set from the Basic Locale.  The following restrictions
       thus apply:

       1. If  basic  locale  setting  is the "C" locale, then all
          other locale categories must be in the "C" locale.

       2. If the Basic Locale is set to a locale other  than  the
          "C"  locale,  then  all other locale categories must be
          set either to a locale that uses the same character set
          as the basic setting, or to the "C" locale.

       The  following methods are available to inform oollwwmm of the
       locale settings, listed in order of priority:

       1. Command line options (such as --bbaassiiccllooccaallee);

       2. by resource database; and

       3. sseettllooccaallee(3C) function defaults (e.g. LANG  environment
          variable).

IINNPPUUTT FFOOCCUUSS
       The   _i_n_p_u_t   _f_o_c_u_s   is  the  window  that  will  receive
       keystrokes.  oollwwmm has two  different  input  focus  modes,
       which  are  different ways of transferring the input focus
       from one window to another.  By default, oollwwmm uses "click-
       to-focus"  (also  known  as  "click-to-type")  mode.  This
       means that you must click on the window in  order  to  get
       the  focus to it.  While a window has the input focus, the
       pointer can be anywhere on the screen; the keyboard events
       will still go to that window.  You can set the input focus
       to a window and simultaneously raise  it  to  the  top  by
       clicking  the  left mouse button in the window's title bar
       or border.

       oollwwmm has another focus mode called  "focus-follows-mouse."



                           25 Nov 1992                          4





olwm(1)                                                   olwm(1)


       In  this  mode,  whatever  window the mouse is pointing to
       will receive the input focus.  To switch the  input  focus
       from one window to another, you simply move the pointer to
       the other window; you don't have to click at  all.   Note,
       however,  that to transfer the focus amongst subwindows of
       a single top-level window, you must click in  the  subwin-
       dow,  or  you  must  use  focus transfer function keys (if
       available from the application).

       The input focus mode can be controlled  with  command-line
       options  or  by entries in the resource database.  Neither
       focus mode has inherent advantages.  Which one you  choose
       is a matter of personal preference.

MMOOUUSSEE BBUUTTTTOONNSS
       OPEN  LOOK  defines  three mouse button functions: SELECT,
       ADJUST, and MENU.  On systems with  three  mouse  buttons,
       these  functions  are mapped to buttons 1, 2, and 3 (left,
       middle, and right)  respectively.   On  systems  with  two
       mouse buttons, SELECT is on button 1 (left) and MENU is on
       button 2 (right).  ADJUST can be performed by holding down
       the  Shift key while pressing button 1.  On systems with a
       single mouse button, that button is SELECT.  Holding Shift
       while  pressing  the button gives ADJUST, and holding Con-
       trol gives MENU.

       There is an alternate style of button  handling  for  two-
       button  mice:  SELECT is button 1, ADJUST is button 2, and
       MENU is performed by holding down buttons 1 and 2 simulta-
       neously.   This  technique  is referred to as mouse button
       _c_h_o_r_d_i_n_g_.  It can be activated on systems with  two-button
       mice by setting the MMoouusseeCChhoorrddMMeennuu resource to true.

MMAANNIIPPUULLAATTIINNGG WWIINNDDOOWWSS AANNDD IICCOONNSS
       _W_i_n_d_o_w _T_i_t_l_e _B_a_r _a_n_d _B_o_r_d_e_r_s_.

       Clicking  SELECT selects the window, raises it above other
       windows, and deselects any other objects.  In  click-focus
       mode,  the  focus  is  also  transferred  to  this window.
       Pressing and holding SELECT and then  dragging  the  mouse
       will  move  windows  without  raising  them or setting the
       focus.  If this window  is  selected,  it  and  all  other
       selected  windows  are  moved  simultaneously.  Otherwise,
       just this window is moved, and it is not selected.  If you
       hold  down  the Control key while you are moving a window,
       motion is constrained either vertically  or  horizontally,
       depending on which direction you move first.

       Double-clicking  SELECT  on  the  window  is  the  same as
       selecting the Full  Size  (or  Restore  Size)  menu  item.
       Clicking  ADJUST  will  toggle  the selected state of this
       window.  If other windows or icons are  already  selected,
       they remain selected.  ADJUST is useful for selecting sev-
       eral windows and icons.  Pressing MENU will bring  up  the



                           25 Nov 1992                          5





olwm(1)                                                   olwm(1)


       window  menu.   See  the  Window  Menu section for further
       details.  If the AAlltt key is held down,  the  mouse  button
       functions  become accessible anywhere over the window, not
       just over the title bar and borders.   The  modifier  used
       can be changed; see the description of the WWMMGGrraabb resource
       in the section on Modifier Customization.

       _R_e_s_i_z_e _C_o_r_n_e_r_s_.

       You can resize a window by  pressing  and  holding  SELECT
       over any of the resize corners and then dragging the mouse
       to the new location.  Releasing the mouse button will  set
       the  new size of the window.  If you hold down the Control
       key while you are dragging, the resize operation  is  con-
       strained  to  resize vertically or horizontally, depending
       on which direction you move first.

       _W_i_n_d_o_w _B_u_t_t_o_n_.

       The Window Button  is  the  small  box  with  a  downward-
       pointing  triangle  near  the  left  end of the title bar.
       Pressing MENU over the window button  will  bring  up  the
       Window  Menu.   Clicking SELECT over the left mouse button
       on the  Window  Button  will  execute  the  window  menu's
       default  action.   This will usually close the window into
       an icon.  You can change the window menu's default  action
       by  holding  down  the  Control key while manipulating the
       window menu.

       _P_u_s_h_p_i_n_.

       OPEN LOOK pop-up windows have a pushpin instead of a  win-
       dow  button.   The  pin  is  either in or out, and you can
       click SELECT on the pin to move it to the other state.  If
       the  pin is out, pressing a command button inside the win-
       dow will execute the command and then dismiss (take  down)
       the  window.   If the pin is in, the window is "pinned" to
       the workspace, and it will remain on the screen even after
       you  have  pressed  a  command button in the window.  This
       allows you to press several command buttons  in  the  same
       window.   Pulling the pin out (by clicking SELECT over it)
       will dismiss the window immediately.

       _I_c_o_n_s_.

       An icon represents a closed window.  You can still do most
       of the same operations as with an open window.  Moving and
       selecting icons with SELECT and ADJUST is exactly the same
       as for open windows.  A similar version of the Window Menu
       is available on an icon by pressing MENU.  Double-clicking
       SELECT will open the icon.  Icons cannot be resized.

NNOONN--RREECCTTAANNGGUULLAARR WWIINNDDOOWWSS
       The  X11  Non-Rectangular Window Shape Extension (commonly



                           25 Nov 1992                          6





olwm(1)                                                   olwm(1)


       referred to simply as the SHAPE extension) allows  windows
       to  have arbitrary shapes.  OOllwwmm will handle these windows
       by giving them no decoration whatsoever.   Shaped  windows
       can  be  manipulated  by using the WMGrab modifier (Alt by
       default) with the mouse buttons.  (See the section on Mod-
       ifier  Customization for further details.)  Shaped windows
       can be moved, resized, closed, opened, etc.  like ordinary
       windows.  The selection feedback for shaped windows is the
       presence of resize corners floating at the corners of  the
       bounding rectangle of the window's shape.

SSEELLEECCTTIIOONNSS OONN TTHHEE WWOORRKKSSPPAACCEE
       You  can  select a group of windows and icons by using the
       left or middle mouse buttons over the Workspace (the  area
       of  the  screen outside of all windows and icons, commonly
       known as the "root window").  Pressing  either  SELECT  or
       ADJUST  and  dragging  the mouse will define a rubber-band
       rectangle.  When you release the mouse button, the set  of
       windows and icons enclosed by this rectangle will be oper-
       ated on.  If you created the rectangle using  SELECT,  the
       windows  and  icons within will be selected, and all other
       objects will be  deselected.   If  you  used  ADJUST,  the
       objects within will have their selected state toggled, and
       any other windows and icons already selected  will  remain
       selected.

MMEENNUU OOPPEERRAATTIIOONN
       In general, pop-up menus are operated using the MENU mouse
       button.  There are two methods of operating with  an  OPEN
       LOOK  menu:  the "click-move-click" method and the "press-
       drag-release" method.  You choose  the  method  either  by
       clicking  the  MENU  button  (pressing  and  releasing  it
       quickly) or by pressing it down and holding  it.   If  you
       click  the MENU button, the menu will pop up and will stay
       up indefinitely.  To continue operating  the  menu,  click
       the  MENU  button  over a menu item.  To dismiss the menu,
       click the MENU button on an area of the screen outside the
       menu.   To operate menus in press-drag-release mode, press
       the MENU button and hold it down while you move the mouse.
       The  menu  will  remain  on the screen as long as you hold
       down the MENU button.  To  execute  an  action,  move  the
       pointer over a menu item and release the mouse button.  To
       dismiss the menu, move the pointer outside  the  menu  and
       release the MENU button.

       Some  menu  items have a sub-menu.  This is indicated by a
       right-pointing triangle at the right edge of the item.  To
       activate a submenu, click on the item (in click-move-click
       mode) or move the pointer to the item and then move toward
       the right edge of the menu (in press-drag-release mode).

       Some  menus  have  pushpins.   If a menu has a pushpin, it
       will initially be in the "out" state.  If you click on the
       pin (in click-move-click mode) or move over it and release



                           25 Nov 1992                          7





olwm(1)                                                   olwm(1)


       (in press-drag-release mode) you will pin the menu to  the
       workspace.   The  menu  will  remain on the screen indefi-
       nitely and you can execute commands from it by clicking on
       its  items.   To  remove  the  menu, move over the pin and
       click SELECT on it.

       The behavior of  menus  can  be  customized  using  oollwwmm's
       resources.   In  the  Global  Resources  section,  see the
       entries for  CClliicckkMMoovveeTThhrreesshhoolldd,  DDrraaggRRiigghhttDDiissttaannccee,  MMuull--
       ttiiCClliicckkTTiimmeeoouutt,  and SSeelleeccttDDiissppllaayyssMMeennuu for further infor-
       mation.

       Some menus may have "accelerators" defined for them.   See
       the section on Menu Accelerators for further details.

WWOORRKKSSPPAACCEE MMEENNUU
       Pressing  MENU  over the workspace brings up the Workspace
       Menu.  This menu is customizable, but  it  typically  con-
       tains at least the following items.  (The items may appear
       in a different language depending on  the  current  locale
       setting.)

       PPrrooggrraammss
              This  item has a sub-menu that allows you to invoke
              applications.  The default Programs  sub-menu  con-
              tains  all  of  the  programs  in  the  OpenWindows
              DeskSet.  However, users typically  customize  this
              menu  to  contain many more programs and to contain
              nested sub-menus.  See the  section  on  Menu  Cus-
              tomization for further information.

       UUttiilliittiieess
              This  item  has  a  sub-menu  that contains several
              utility  functions  for  the  workspace,  including
              Refresh (redisplay all windows on the screen), Lock
              Screen, and Save Workspace.

       PPrrooppeerrttiieess......
              This item brings up the Workspace  Properties  win-
              dow,  which  allows  you to view and customize set-
              tings of the OpenWindows environment.

       HHeellpp......
              Brings up the table of contents of the  Help  Hand-
              books.

       DDeesskkttoopp IInnttrroo......
              Brings  up a tutorial introduction to the Sun Desk-
              top.

       EExxiitt   Shuts down all applications and  exits  the  window
              system.  A confirmation notice will appear first to
              give you a chance to cancel the operation.




                           25 Nov 1992                          8





olwm(1)                                                   olwm(1)


WWIINNDDOOWW MMEENNUU
       The window menu of most windows has the  following  items.
       (The items may appear in a different language depending on
       the current locale setting.)

       CClloossee  Closes the window to an icon.  Any OPEN LOOK pop-up
              windows  are  closed  into this icon as well.  They
              will reappear when the icon is opened.   This  item
              is "Open" if you bring up this menu over an icon.

       FFuullll SSiizzee
              Expands  the  window  to  the  full  height  of the
              screen.  If this has already done,  the  button  is
              Normal  Size  instead  of  Full  Size.  Normal Size
              restores the window to the size it was  before  you
              did  the  Full  Size operation.  If the application
              has specified a maximum size for the  window,  this
              size  is  used  for  Full  Size instead of the full
              screen height.

       MMoovvee   Starts the keyboard-based form of moving  the  win-
              dow.   Appears  only if OPEN LOOK Mouseless Mode is
              enabled.

       RReessiizzee Starts the keyboard-based form of resizing the win-
              dow.   Appears  only if OPEN LOOK Mouseless Mode is
              enabled.

       BBaacckk   Moves the window behind all other windows.

       RReeffrreesshh
              Clears and redisplays the window.

       QQuuiitt   Kills the program running in the window and removes
              the window.  If the application has elected to par-
              ticipate in  the  WM_DELETE_WINDOW  protocol,  oollwwmm
              sends  a  WM_DELETE_WINDOW ClientMessage instead of
              killing that window.

       OPEN LOOK pop-up windows (as opposed to base windows) have
       a smaller window menu.  It lacks the Close, Full Size, and
       Quit items, but it has two new items:

       DDiissmmiissss
              Causes the window to be dismissed.  This button has
              a  sub-menu with two items: This Window, which dis-
              misses just this window,  and  All  Pop-ups,  which
              dismisses all pop-up windows owned by this applica-
              tion.

       OOwwnneerr?? Raises and flashes the title bar of the base window
              that "owns" this pop-up window.





                           25 Nov 1992                          9





olwm(1)                                                   olwm(1)


MMEENNUU CCUUSSTTOOMMIIZZAATTIIOONN FFIILLEESS
       You  can customize oollwwmm's Workspace Menu by putting a menu
       description into a file that  oollwwmm  will  read.   When  it
       starts  up,  oollwwmm  will first look for a file named by the
       OLWMMENU environment variable.  If this variable does  not
       exist, or if the file is not readable, oollwwmm will then look
       in the file named ..ooppeennwwiinn--mmeennuu in  your  home  directory.
       If  this  file  is not present or is unreadable, oollwwmm will
       fall back on the system default menu file.  If,  for  some
       reason, the system default menu file cannot be found, oollwwmm
       will use a minimal, built-in menu.  The menu file that  is
       read  can  also be modified by the display language locale
       setting.  The locale name is used  as  a  suffix  for  the
       filename.   If  a localized menu file is found, it is used
       in preference to the non-localized menu file.   For  exam-
       ple,  if  the  display  language locale is "japanese", the
       file ..ooppeennwwiinn--mmeennuu..jjaappaanneessee will take precedence over  the
       file ..ooppeennwwiinn--mmeennuu.

       OOllwwmm will automatically re-read its menu file whenever the
       menu file changes.  This lets you make many small  changes
       to  a  menu  file, trying out the modified menu after each
       change.  The automatic re-reading can be  controlled  with
       the AAuuttooRReeRReeaaddMMeennuuFFiillee resource.

       If  oollwwmm  encounters  a syntax error during the reading of
       any menu file, a message is printed to the standard  error
       file  and  the  reading of this menu file is considered to
       have failed.  OOllwwmm will then attempt to read the next file
       in the sequence as described above.

MMEENNUU SSPPEECCIIFFIICCAATTIIOONN SSYYNNTTAAXX
       The  menu specification language has a number of keywords,
       all of which are in all upper case letters.  The  keywords
       are  _n_o_t translated into the language specified by the the
       locale category settings.  Keywords are always in English.

       Each  line typically specifies one menu button.  There are
       three fields on each line: a label, the  optional  keyword
       DEFAULT, and a command.  The label is either a single word
       or a string enclosed in double quotes.  This is the  label
       that  appears in the menu button.  If the optional keyword
       DEFAULT appears next, this menu item becomes  the  default
       item for this menu.  The rest of the line (excluding lead-
       ing whitespace) is considered to be a command.  It is exe-
       cuted  by  sending  it to sshh(1).  Any shell metacharacters
       will be passed through to the shell unchanged.   The  com-
       mand field can be extended onto the next line by placing a
       backslash `\' at the end of the line.   The  newline  will
       not be embedded in the command.

       A  sub-menu is specified using the special keyword MENU in
       place of a command.  A button  is  added  to  the  current
       menu,  and  clicking  or pulling right on this button will



                           25 Nov 1992                         10





olwm(1)                                                   olwm(1)


       bring up the sub-menu.  Subsequent lines in the menu  file
       define buttons for the sub-menu, until a line that has the
       special keyword END in the command field  is  encountered.
       The label of the MENU line must match the label on the END
       line, otherwise an error is signaled.   Sub-menus  can  be
       nested  arbitrarily,  bracketed by MENU and END lines with
       matching labels.

       Sub-menus can be defined in a different file using  either
       the  MENU  or  the INCLUDE keyword.  To include a sub-menu
       from another file, use a line with  a  label,  either  the
       MENU  or  the INCLUDE keyword, and then the filename.  The
       file so named is assumed to  contain  lines  that  specify
       menu buttons.  The sub-menu file need not have any MENU or
       END lines (unless it has sub-menus itself).   The  current
       file  need not have a matching END line if the sub-menu is
       read from another file.  Sub-menu files included with  the
       MENU  keyword are considered to be an integral part of the
       menu tree, and any error encountered during reading of the
       file  will cause the entire menu to be considered invalid.
       A sub-menu file included with the INCLUDE keyword is  con-
       sidered optional, and any error encountered during reading
       of the file is not considered fatal.  If an  error  occurs
       during INCLUDE processing, a disabled (grayed-out) item is
       inserted in place of the sub-menu and  processing  of  the
       current menu file continues.

       To make a sub-menu pinnable, add the special keyword "PIN"
       after the END keyword on the line that ends  the  sub-menu
       definition, or after the TITLE directive (see below).

       By  default,  the  label  in  a menu button is used as the
       title of the sub-menu.  This can be overridden by specify-
       ing  a line that has the special keyword TITLE in the com-
       mand field.  The label from this line will be used as  the
       sub-menu's  title.   This  line can appear anywhere in the
       sub-menu definition.  It does not add an item to the menu.
       In  addition, if the PIN keyword follows the TITLE keyword
       on this line, the sub-menu will be  made  pinnable.   This
       construct  is useful for declaring that a sub-menu defined
       in a separate file be pinnable.

       A line containing only  the  keyword  SEPARATOR  will  add
       extra space before the next item.

       The following keywords can be used in the command field of
       a menu item.  They specify functions that are internal  to
       oollwwmm,, that are not invoked by running a shell.

       BACK_SELN
              Move  the  selected  windows and icons behind other
              windows.

       EXIT



                           25 Nov 1992                         11





olwm(1)                                                   olwm(1)


              Kills all applications and exits the window manager
              after  getting confirmation from the user.  This is
              useful for exiting the entire window system.

       EXIT_NO_CONFIRM
              Like EXIT but skips the confirmation notice.

       FLIPDRAG
              Toggle the state of the DDrraaggWWiinnddooww resource.

       FLIPFOCUS
              Toggle the state of the SSeettIInnppuutt resource.

       FULL_RESTORE_SIZE_SELN
              Toggle the full-sized/normal-sized  states  of  the
              selected windows and icons.

       NOP
              No operation; don't do anything.

       OPEN_CLOSE_SELN
              Toggle  the  opened/closed  states  of the selected
              windows and icons.

       QUIT_SELN
              Quit the selected windows and icons.

       PROPERTIES
              Bring up Workspace Properties.

       REFRESH
              Refresh causes all windows  on  the  screen  to  be
              repainted.

       REREAD_MENU_FILE
              Force  an immediate rereading of the workspace menu
              customization file.  OOllwwmm  will  start  a  complete
              search  for  a  menu file (as described in the _M_e_n_u
              _C_u_s_t_o_m_i_z_a_t_i_o_n section) and use the first valid file
              it finds.

       RESTART
              Restart the window manager by issuing an eexxeecc(2) on
              aarrggvv..  This shouldn't affect any  running  applica-
              tions, nor should it cause the server to shut down.

       SAVE_WORKSPACE
              Take a snapshot of the  set  of  currently  running
              applications, and put the command lines so obtained
              into the file ".openwin-init" in  the  user's  home
              directory.   This runs the command specified by the
              SSaavveeWWoorrkkssppaacceeCCmmdd resource.





                           25 Nov 1992                         12





olwm(1)                                                   olwm(1)


       START_DSDM
              Start providing the DSDM service.  See the  section
              on Drag and Drop for further information.

       STOP_DSDM
              Stop  providing  the DSDM service.  See the section
              on Drag and Drop for further information.

       WMEXIT Exit the window manager without killing any  appli-
              cations.

       Here is an example root menu specification.

       "My Custom Menu" TITLE

       Programs        MENU
            "Command Tool"      DEFAULT cmdtool
            "Text Editor"       textedit
            Mail           mailtool
            "File Manager"      filemgr
            Other               MENU
                 "Other Tools"       TITLE
                 "Shell Tool"        shelltool
                 "Icon Editor"       iconedit
                 Clock               clock
                 "Perf Meter"        DEFAULT perfmeter
            Other               END
       Programs       END PIN

       "Repaint Screen"    REFRESH

       "Properties ..."    PROPERTIES

       Exit      EXIT

CCOOLLOORRMMAAPP IINNSSTTAALLLLAATTIIOONN
       OOllwwmm  will  handle  colormap installation for windows that
       have colormaps other than the default colormap.  There are
       two   colormap   focus  modes:  "color-follows-mouse"  and
       "color-locked".  They are roughly analogous to the  corre-
       sponding  modes  for  input  focus.  However, the colormap
       focus mode can be  completely  independent  of  the  input
       focus  mode.   The  mode  in which the system starts up is
       determined by the CCoolloorrFFooccuussLLoocckkeedd resource.

       OOllwwmm keeps track of a set of windows that are eligible  to
       have  their  colormaps  installed.   This set includes all
       top-level windows of clients.  If any clients have  speci-
       fied  other  windows  in  a  WM_COLORMAP_WINDOWS property,
       these windows are included in the set as well.   The  win-
       dows  listed  in  this property need not be top-level win-
       dows; they can be nested subwindows as well.

       In color-follows-mouse  mode,  oollwwmm  keeps  track  of  the



                           25 Nov 1992                         13





olwm(1)                                                   olwm(1)


       location  of  the  pointer  and always keeps installed the
       colormap of the eligible window  underneath  the  pointer.
       Thus,  you can install the colormap of a particular window
       simply by sliding the pointer into it.  The  default  col-
       ormap  will  be  restored if you move the pointer back out
       into a window frame or into the workspace.  In this  mode,
       the   WM_COLORMAP_WINDOWS   properties   are  tracked  for
       changes, but only to change the set of  eligible  windows.
       Changes  to  these  properties  only cause colormaps to be
       installed if the eligible window  under  the  pointer  has
       changed  as a result of the set of eligible windows chang-
       ing.  In this mode, no window is considered  to  have  the
       colormap  focus;  colormap  installation entirely is under
       control of the user.

       In color-locked mode, colormaps are not installed based on
       pointer  motion.  Instead, colormaps are installed explic-
       itly by the user using  function  keys  or  by  a  program
       changing  the contents of the WM_COLORMAP_WINDOWS property
       on its top-level window.

       The user can install the colormap of a window (or  subwin-
       dow  listed in the WM_COLORMAP_WINDOWS property) by moving
       the pointer over the window or subwindow and pressing  the
       Color-Lock  key (which is bound to Control-L2 by default).
       This will install the colormap of the window or  subwindow
       under  the  pointer,  and  it will also grant the colormap
       focus to the top-level window.  When a window has the col-
       ormap  focus,  oollwwmm  will  honor  changes to this window's
       WM_COLORMAP_WINDOWS property by installing the colormap of
       the first window named in this property.  In this way, the
       application whose window has the colormap focus  can  con-
       trol colormap installation by altering the contents of the
       WM_COLORMAP_WINDOWS property.

       Note that, according to the ICCCM, if  WM_COLORMAP_WINDOWS
       does  not  include  the top-level window, it is assumed to
       occur first in the list.  If  you  want  your  program  to
       request    colormap    installation    via    changes   to
       WM_COLORMAP_WINDOWS, you must make sure that the top-level
       window  appears  somewhere  in  this property.  Otherwise,
       oollwwmm will always install the  colormap  of  the  top-level
       window.

       The  colormap  focus  may  be given to a window in several
       other ways.  If you press the Color-Lock key over  a  win-
       dow's  title  bar or border, that window will be given the
       colormap   focus   and   the   first   window    in    the
       WM_COLORMAP_WINDOWS  property  will  be installed.  If the
       AAuuttooCCoolloorrFFooccuuss resource is set, new windows will be  given
       the  colormap  focus automatically.  If the CCoolloorrTTrraacckkssIInn--
       ppuuttFFooccuuss resource is set, the colormap focus  will  always
       be given to the window that has the input focus.




                           25 Nov 1992                         14





olwm(1)                                                   olwm(1)


       If  you  press  the Color-Lock key over the workspace, the
       default colormap will be installed, and  any  window  with
       the  colormap focus will lose it.  The root window is then
       considered to have the colormap focus.  At any  time,  you
       can  revert  to  color-follows-mouse  mode by pressing the
       Color-Unlock key.  Any window with the colormap focus will
       lose it.

SSPPOOTT HHEELLPP
       OOllwwmm  provides  spot help for frames, icons, the Workspace
       and Window menus, window buttons,  resize  corners,  push-
       pins,  and the Workspace itself.  This is done via a sepa-
       rate slave program, oollwwmmssllaavvee(1)..  The  slave  program  is
       forked  automatically when oollwwmm starts up.  The forking of
       the slave program can be controlled by the RRuunnSSllaavveePPrroocceessss
       resource.

MMUULLTTIIPPLLEE SSCCRREEEENNSS
       By default, oollwwmm will manage windows on all screens of the
       display server.  Most operations are unchanged from single
       screen  operation.  A window exists on a particular screen
       for its entire lifetime.  The window cannot be moved  from
       one  screen  to  another, nor can it be resized to cross a
       screen boundary.  Windows invoked from the Workspace  menu
       will  appear  on  the  same screen as the menu.  Spot help
       will appear on the same screen as  the  pointer  when  the
       Help key is pressed.

       Previous  releases  required  modifications  to the user's
       ..xxiinniittrrcc script to start multiple instances of  oollwwmm,,  one
       for each screen.  These modifications are no longer neces-
       sary.  The default XXiinniittrrcc (which contains a single  invo-
       cation  of oollwwmm) works for both single and multiple screen
       situations.

DDRRAAGG AANNDD DDRROOPP
       The OpenWindows drag and drop system relies  on  a  third-
       party  client (i.e. a client other than the source or des-
       tination clients of a drag and drop operation) to maintain
       a  database  of all possible locations on the screen where
       an object may be dropped.  These locations are referred to
       as ``drop sites.''  This third party client is thus called
       the Drop Site Database Manager or DSDM.  By default,  oollwwmm
       is  configured  to  provide  the  DSDM service to clients.
       This can be controlled using the SSttaarrttDDSSDDMM resource or the
       --ddssddmm and --nnooddssddmm command-line options.

       If  you  have customized your Workspace Menu (see the sec-
       tion on Menu Customization) you can add items that use the
       START_DSDM  and  STOP_DSDM menu keywords.  Invoking a menu
       item bound to one of these keywords will enable or disable
       oollwwmm's providing of the DSDM service.

       A standalone client ddssddmm(1) exists in order to provide the



                           25 Nov 1992                         15





olwm(1)                                                   olwm(1)


       DSDM service in the case where oollwwmm is not running  or  if
       it  has  been  directed  not  to provide the DSDM service.
       Note that the START_DSDM and STOP_DSDM  functions  do  not
       run  an  actual ddssddmm process; rather, they control whether
       oollwwmm provides the DSDM service itself.  It is  not  neces-
       sary to run ddssddmm if oollwwmm is providing the DSDM service.

GGLLOOBBAALL RREESSOOUURRCCEESS
       Global  resources  in  oollwwmm consist of two resource compo-
       nents.  The first component in the resource name is  taken
       from  the  trailing  pathname  component of aarrggvv[[00]].  This
       value is typically `olwm'.  This name can  be  altered  by
       using   the   --nnaammee  command-line  argument.   The  second
       resource component names the global attribute  being  set.
       It  should  be  one  of the names from the following list.
       Thus, to set the AAuuttooCCoolloorrFFooccuuss attribute, one  would  use
       "olwm.AutoColorFocus" as the resource specification.

       OOllwwmm  will  automatically pick up changes to many of these
       resources if the resource database  changes  at  run-time.
       One  can  thus  modify  oollwwmm's  behavior  by  changing the
       resource database with xxrrddbb(1) or with  Workspace  Proper-
       ties.   If a resource value is specified on oollwwmm's command
       line, it will override the value in the resource database,
       and  thus  changing  the  resource's value in the database
       will have no effect on this resource setting.

       Some  resources  are  also  interpreted  by   XView   (see
       xxvviieeww(7))  and are set by the Workspace Properties program
       (see pprrooppss(1)).   For  these  resources,  oollwwmm  will  also
       accept the string `OpenWindows' as the first resource com-
       ponent.  These resources are marked with an asterisk  `*'.

       Colors  can  be  specified using the formats parsed by the
       Xlib XParseColor() function.   Common  formats  are  color
       names  (see  sshhoowwrrggbb(1)) and explicit red, green, and blue
       values in hexadecimal, preceded by a `#'.  For example,  a
       cyan  (full  green  and  blue)  would  be  specified  with
       "#00ffff".

       Boolean values can be specified  with  the  words  "true",
       "false",  "on",  "off",  "yes",  "no",  "1", "0", "t", and
       "nil".

       AAuuttooCCoolloorrFFooccuuss _(_b_o_o_l_e_a_n_)
              Indicates whether newly appearing windows are to be
              given  the  colormap  focus automatically.  See the
              section  on  Colormap  Installation   for   further
              details.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       AAuuttooIInnppuuttFFooccuuss _(_b_o_o_l_e_a_n_)
              Indicates whether newly appearing windows are to be
              given  the  input  focus  automatically.    _D_e_f_a_u_l_t
              _v_a_l_u_e_: _f_a_l_s_e_.



                           25 Nov 1992                         16





olwm(1)                                                   olwm(1)


       AAuuttooRRaaiissee _(_b_o_o_l_e_a_n_)
              Raise  windows  automatically when they receive the
              focus.  This is useful  in  click-to-focus  if  you
              always  like to type into the topmost window.  This
              is   useful   in   focus-follow-mouse   when    the
              AAuuttooRRaaiisseeDDeellaayy  resource  is  set  to  a reasonable
              value.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       AAuuttooRRaaiisseeDDeellaayy _(_i_n_t_e_g_e_r_)
              Amount of time to delay, in microseconds, between a
              window  receiving  the  focus  and raising it above
              other windows.  Effective only when  the  value  of
              the  AAuuttooRRaaiissee resource is true.  _D_e_f_a_u_l_t _v_a_l_u_e_: _0_.

       AAuuttooRReeRReeaaddMMeennuuFFiillee _(_b_o_o_l_e_a_n_)
              Specifies whether the menu file is  to  be  re-read
              whenever it changes.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       BBaacckkggrroouunndd _(_c_o_l_o_r_)
              Specifies  the  background color.  This is used for
              the background of masked icons.  Note:  it  is  not
              used  for  the  backgrounds of icon windows such as
              those used by XView (see xxvviieeww(7)).  This  resource
              is  also  distinct  from  the WWiinnddoowwCCoolloorr resource.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _w_h_i_t_e_.

       BBaassiiccLLooccaallee _(_l_o_c_a_l_e _n_a_m_e_)
              Specifies the basic OPEN LOOK locale category  set-
              ting.   See the section on Locale Handling for more
              details.

       BBeeeepp _(_e_n_u_m_e_r_a_t_i_o_n_) **
              Specifies the circumstances under which oollwwmm should
              beep.  Permissible values are the strings "always",
              "never", and "notices".  The string  "never"  means
              that  oollwwmm  should never beep, "notices" means that
              oollwwmm should beep only when a  notice  appears,  and
              "always"  means  that oollwwmm will beep whenever it is
              appropriate.  _D_e_f_a_u_l_t _v_a_l_u_e_: _a_l_w_a_y_s_.

       BBoorrddeerrCCoolloorr _(_c_o_l_o_r_)
              Specifies the color used for window and  icon  bor-
              ders.  _D_e_f_a_u_l_t _v_a_l_u_e_: _b_l_a_c_k_.

       BBuuttttoonnFFoonntt _(_f_o_n_t _n_a_m_e_)
              Font  to  be used for buttons in menus and notices.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _L_u_c_i_d_a_-_S_a_n_s_-_1_2_.

       CClliicckkMMoovveeTThhrreesshhoolldd _(_i_n_t_e_g_e_r_)
              This value is used when bringing up a menu.  If the
              pointer  moves more than this amount while the menu
              button is down, the menu is  considered  to  be  in
              press-drag-release mode.  Otherwise, the menu is in
              click-move-click mode.  _D_e_f_a_u_l_t _v_a_l_u_e_: _5_.



                           25 Nov 1992                         17





olwm(1)                                                   olwm(1)


       CCoolloorrFFooccuussLLoocckkeedd _(_b_o_o_l_e_a_n_)
              Specifies the initial state of the  colormap  focus
              policy.   If  true,  the default colormap is locked
              into the hardware.  If false, the colormap  of  the
              window  under  the  pointer is kept installed.  See
              the section on Colormap  Installation  for  further
              details.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       CCoolloorrTTrraacckkssIInnppuuttFFooccuuss _(_b_o_o_l_e_a_n_)
              If true, indicates that the colormap focus is to be
              set automatically to any window that  receives  the
              input focus.  See the section on Colormap Installa-
              tion for further details.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       CCuurrssoorrFFoonntt _(_f_o_n_t _n_a_m_e_)
              Specifies the font to be used for cursors.   It  is
              probably  not useful to change this unless you have
              an alternate cursor font with the same encoding  as
              the OPEN LOOK cursor font.  _D_e_f_a_u_l_t _v_a_l_u_e_:
              _-_s_u_n_-_o_p_e_n _l_o_o_k _c_u_r_s_o_r_-_*_-_*_-_*_-_*_-_*_-_1_2_0_-_*_-_*_-_*_-_*_-_*_-_*_.

       DDeeffaauullttIIccoonnIImmaaggee _(_f_i_l_e_n_a_m_e_)
              Specifies  a file containing a bitmap to be used as
              the default icon image.

       DDeeffaauullttIIccoonnMMaasskk _(_f_i_l_e_n_a_m_e_)
              Specifies a file containing a bitmap to be used  as
              the default icon mask.

       DDeeffaauullttTTiittllee _(_s_t_r_i_n_g_)
              Specifies the string to be used in the title bar of
              windows that have not  provided  a  string  in  the
              WM_NAME property.  _D_e_f_a_u_l_t _v_a_l_u_e_: _N_o _N_a_m_e_.

       DDiissppllaayyLLaanngg _(_l_o_c_a_l_e _n_a_m_e_)
              Specifies  the  display  language  OPEN LOOK locale
              category.  See the section on Locale  Handling  for
              more details.

       DDrraaggRRiigghhttDDiissttaannccee _(_i_n_t_e_g_e_r_) **
              The number of pixels you must drag the mouse to the
              right in a menu item to bring up a  sub-menu.   The
              sub-menu  always  comes  up  when you move over the
              menu mark (the right-pointing triangle), regardless
              of the drag-right distance.  _D_e_f_a_u_l_t _v_a_l_u_e_: _1_0_0_.

       DDrraaggTThhrreesshhoolldd _(_i_n_t_e_g_e_r_) **
              This  is  the  number of pixels the mouse must move
              while a mouse button is down in order to  have  the
              action  be  considered  a drag.  If the mouse moves
              fewer than this number of pixels while  the  button
              is  down, it is considered to be click instead of a
              drag.  _D_e_f_a_u_l_t _v_a_l_u_e_: _5_.




                           25 Nov 1992                         18





olwm(1)                                                   olwm(1)


       DDrraaggWWiinnddooww _(_b_o_o_l_e_a_n_)
              If true, drags the entire image of the window  when
              you move it.  Otherwise, just drags the window out-
              line.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       EEddggeeMMoovveeTThhrreesshhoolldd _(_i_n_t_e_g_e_r_)
              Specifies the amount of "hysteresis" provided  when
              moving  windows  past the edge of the screen.  When
              you move a window or an icon, it will pause when it
              touches  the  edge of the screen.  This is to allow
              you to easily position windows right up against the
              edge  of the screen.  If you move farther, the win-
              dow or icon will continue to move  past  the  edge.
              You  can  prevent windows from ever lapping off the
              screen by setting an extremely  large  value  (say,
              10000)  for this resource, and you can disable this
              feature entirely by specifying  a  value  of  zero.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _1_0_.

       FFllaasshhCCoouunntt _(_i_n_t_e_g_e_r_)
              Number  of  times the title bar is flashed when the
              "Owners?" menu item is activated.   _D_e_f_a_u_l_t  _v_a_l_u_e_:
              _6_.

       FFllaasshhTTiimmee _(_i_n_t_e_g_e_r_)
              Amount  of  time,  in  microseconds,  for which the
              title bar is flashed when the "Owner?" menu item is
              activated.  _D_e_f_a_u_l_t _v_a_l_u_e_: _1_0_0_0_0_0_.

       FFooccuussLLeenniieennccee _(_b_o_o_l_e_a_n_)
              If  this  is set to true, oollwwmm will not enforce the
              ICCCM requirement that windows must have the  input
              hint set in order to receive the input focus.  This
              option is useful if you  run  clients  that  aren't
              ICCCM-compliant,  like  many  X11R3-based  clients.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       FFoorreeggrroouunndd _(_c_o_l_o_r_)
              Specifies the foreground color.  This color is used
              mainly  for  the text of window and icon titles and
              in menus.  _D_e_f_a_u_l_t _v_a_l_u_e_: _b_l_a_c_k_.

       GGllyypphhFFoonntt _(_f_o_n_t _n_a_m_e_)
              Glyph font used for  drawing  OPEN  LOOK  graphics.
              Changing  this  font  is mainly useful for changing
              its size.  Specifying a different font, such  as  a
              text  font,  will  result  in undesirable behavior.
              _D_e_f_a_u_l_t _v_a_l_u_e_:
              _-_s_u_n_-_o_p_e_n _l_o_o_k _g_l_y_p_h_-_*_-_*_-_*_-_*_-_*_-_1_2_0_-_*_-_*_-_*_-_*_-_*_-_*_.

       IIccoonnFFllaasshhCCoouunntt _(_i_n_t_e_g_e_r_)
              Number of times  to  flash  the  open/close  "zoom"
              lines.  _D_e_f_a_u_l_t _v_a_l_u_e_: _3_.




                           25 Nov 1992                         19





olwm(1)                                                   olwm(1)


       IIccoonnFFllaasshhOOffffTTiimmee _(_i_n_t_e_g_e_r_)
              Amount  of  time  to  pause, in microseconds, while
              open/close "zoom" lines are not  visible.   _D_e_f_a_u_l_t
              _v_a_l_u_e_: _1_.

       IIccoonnFFllaasshhOOnnTTiimmee _(_i_n_t_e_g_e_r_)
              Amount  of  time  to  pause, in microseconds, while
              open/close  "zoom"  lines  are  visible.    _D_e_f_a_u_l_t
              _v_a_l_u_e_: _2_0_0_0_0_.

       IIccoonnFFoonntt _(_f_o_n_t _n_a_m_e_)
              Font used for icon names.  _D_e_f_a_u_l_t_: _L_u_c_i_d_a_-_S_a_n_s_-_1_2_.

       IIccoonnLLooccaattiioonn _(_e_n_u_m_e_r_a_t_i_o_n_) **
              One of the words "top-lr",  "top-rl",  "bottom-lr",
              "bottom-rl",  "left-tb",  "left-bt", "right-tb", or
              "right-bt".  These specify  that  icons  should  be
              arranged  along  a  particular  edge of the screen,
              ordered from left to right  or  top  to  bottom  as
              appropriate.   The  words  "top", "bottom", "left",
              and "right" are synonyms for "top-lr", "bottom-lr",
              "left-tb",  and  "right-tb", respectively.  _D_e_f_a_u_l_t
              _v_a_l_u_e_: _b_o_t_t_o_m_.

       IInnvveerrttFFooccuussHHiigghhlliigghhttiinngg _(_b_o_o_l_e_a_n_)
              In click-to-focus,  the  input  focus  is  normally
              indicated  by  a  solid rectangle in the title bar.
              In focus-follows-mouse, focus is normally indicated
              with  two lines in the title bar.  If this resource
              is true, the style of highlighting is inverted with
              respect  to  the  focus style.  This results in two
              lines for click-to-focus and a solid bar for focus-
              follows-mouse.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       KKeeeeppTTrraannssiieennttssAAbboovvee _(_b_o_o_l_e_a_n_)
              Specifies whether oollwwmm should attempt to keep tran-
              sient windows above their  owner  window.   _D_e_f_a_u_l_t
              _v_a_l_u_e_: _f_a_l_s_e_.

       KKeeyybbooaarrddCCoommmmaannddss _(_e_n_u_m_e_r_a_t_i_o_n_) **
              Permissible  values for this resource are SSuunnVViieeww11,,
              BBaassiicc,, and FFuullll..  Values  are  case-sensitive.   In
              FFuullll  mode, all OPEN LOOK Mouseless commands imple-
              mented by the window manager are active.   See  the
              section  on Mouseless Navigation for further infor-
              mation.  In BBaassiicc mode, the keys active  are  Open,
              Front,  Help,  and  the colormap keys.  In SSuunnVViieeww11
              mode, the only keys  active  are  Open  and  Front.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _B_a_s_i_c_.

       MMeennuuAAcccceelleerraattoorrss _(_b_o_o_l_e_a_n_)
              Determines  whether  menu  accelerators are active.
              Used in conjunction with the WWiinnddoowwMMeennuuAAcccceelleerraattoorrss
              resource.   Both  must  be  set  to  true  for menu



                           25 Nov 1992                         20





olwm(1)                                                   olwm(1)


              accelerators to be active.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       MMiinniimmaallDDeeccoorr _(_l_i_s_t _o_f _s_t_r_i_n_g_s_)
              Specifies a list of windows that are  to  be  deco-
              rated   minimally.    Decoration  on  such  windows
              includes only a thin  border  and  resize  corners,
              with  no  title  bar  or  window button.  The value
              should be a whitespace-separated list  of  strings.
              Each  string  should specify an application's class
              or instance name, as passed in the  WM_CLASS  prop-
              erty.  Most applications set this property based on
              the name of the  executable  (i.e.  argv[0]).   For
              example, to specify that the clock and the calcula-
              tor should be decorated minimally,  you  would  use
              the following resource:

                   olwm.MinimalDecor: calctool clock

              Many  applications  will  allow you to override the
              value of the  WM_CLASS  property  using  the  --nnaammee
              option on the command line.  _D_e_f_a_u_l_t _v_a_l_u_e_: _(_n_u_l_l_)_.

       MMoouusseeCChhoorrddMMeennuu _(_b_o_o_l_e_a_n_)
              If true, uses a chorded  mouse  button  combination
              for MENU instead of shift keys.  See the Mouse But-
              tons section for further details.   _D_e_f_a_u_l_t  _v_a_l_u_e_:
              _f_a_l_s_e_.

       MMoouusseeCChhoorrddTTiimmeeoouutt _(_i_n_t_e_g_e_r_)
              Specifies the amount of time, in milliseconds, that
              oollwwmm is to wait for  subsequent  events  to  disam-
              biguate   chorded  mouse  button  event  sequences.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _1_0_0_.

       MMuullttiiCClliicckkTTiimmeeoouutt _(_i_n_t_e_g_e_r_) **
              The time, in tenths of a second,  that  differenti-
              ates  a  double-click from two single clicks.  This
              value is also used to distinguish  the  click-move-
              click and press-drag-release modes of pop-up menus.
              If the MENU button is held down  longer  than  this
              amount  of  time,  the  menu is considered to be in
              press-drag-release mode, otherwise it is considered
              to  be in click-move-click mode.  _D_e_f_a_u_l_t _v_a_l_u_e_: _5_.

       NNuummeerriicc _(_l_o_c_a_l_e _n_a_m_e_)
              Specifies the numeric format OPEN LOOK locale cate-
              gory.   See the section on Locale Handling for more
              details.

       PPaaiinnttWWoorrkkssppaaccee _(_b_o_o_l_e_a_n_)
              If true, oollwwmm will use the WWoorrkkssppaacceeCCoolloorr  resource
              to  set  the  workspace  (root  window)  background
              color.  If false, oollwwmm will  not  change  the  root
              window background.  This is useful If you prefer to



                           25 Nov 1992                         21





olwm(1)                                                   olwm(1)


              set your own workspace color using xxsseettrroooott(1) or a
              similar program.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       PPooiinntteerrWWoorrkkssppaaccee _(_b_o_o_l_e_a_n_)
              If  true, oollwwmm will set the workspace (root window)
              cursor.  If false, oollwwmm will not  change  the  root
              window cursor.  This is useful if you prefer to set
              your own workspace cursor using  xxsseettrroooott(1)  or  a
              similar program.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       PPPPoossiittiioonnCCoommppaatt _(_b_o_o_l_e_a_n_)
              Turns  on backward compatibility for older applica-
              tions that have a habit of always setting the  PPo-
              sition  flag  in the WM_NORMAL_HINTS property, even
              when they haven't set a position.  This most  often
              occurs  with X11R3-based clients.  Without backward
              compatibility, these windows will always appear  in
              the upper-left corner of the screen.  With backward
              compatibility, these  windows  will  be  positioned
              according to the default OPEN LOOK window placement
              policy, along the diagonal  of  the  screen.   This
              option will not affect windows that have a geometry
              specified on  the  command  line.   _D_e_f_a_u_l_t  _v_a_l_u_e_:
              _f_a_l_s_e_.

       PPooppuuppJJuummppCCuurrssoorr _(_b_o_o_l_e_a_n_) **
              Specifies whether to warp the cursor to pop-up win-
              dows.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       PPrriinnttWWaarrnniinnggss _(_b_o_o_l_e_a_n_)
              Determines whether oollwwmm will issue non-fatal  warn-
              ing  messages  (such  as  X protocol errors) to its
              standard error file.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       RRaaiisseeOOnnAAccttiivvaattee _(_b_o_o_l_e_a_n_)
              Specifies whether a window is to be raised when  it
              is  activated  via  a  Mouseless  command.  _D_e_f_a_u_l_t
              _v_a_l_u_e_: _t_r_u_e_.

       RRaaiisseeOOnnMMoovvee _(_b_o_o_l_e_a_n_)
              Tells oollwwmm to raise a window whenever it  is  moved
              by the user.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       RRaaiisseeOOnnRReessiizzee _(_b_o_o_l_e_a_n_)
              Tells oollwwmm to raise a window whenever it is resized
              by the user.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       RReeffrreesshhRReeccuurrssiivveellyy _(_b_o_o_l_e_a_n_)
              Determines how the Refresh menu items on the window
              and workspace menus operate.  If the value is true,
              oollwwmm will walk the window hierarchy and send  expo-
              sure  events  to  every window.  This is useful for
              refreshing windows that have backing store.  If the
              value  is  false,  oollwwmm  will map a window and then



                           25 Nov 1992                         22





olwm(1)                                                   olwm(1)


              unmap it, causing all windows  underneath  that  do
              not  have  backing  store get exposures.  When this
              feature is on, the Refresh  operation  generates  a
              large  amount  of client-server traffic.  It may be
              useful to turn this feature off if  the  connection
              transport   has  low  bandwidth  or  high  latency.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       RReevveerrsseeVViiddeeoo _(_b_o_o_l_e_a_n_)
              If true, reverses the sense of black and  white  on
              monochrome  screens.   Ignored  for  color screens.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       RRuubbbbeerrBBaannddTThhiicckknneessss _(_i_n_t_e_g_e_r_)
              Specifies the thickness of the  "rubber-band"  line
              that  is  drawn  when  a  window is resized, when a
              group of windows is selected by dragging a  rectan-
              gle on the root, and when a window is moved and the
              value of the DDrraaggWWiinnddooww resource is false.  _D_e_f_a_u_l_t
              _v_a_l_u_e_: _2_.

       RRuunnSSllaavveePPrroocceessss _(_b_o_o_l_e_a_n_)
              If  false,  disables the running of oollwwmmssllaavvee(1) at
              startup time.  If the slave process is not running,
              Spot Help will not be available on objects owned by
              oollwwmm such as pushpins and resize corners.   _D_e_f_a_u_l_t
              _v_a_l_u_e_: _t_r_u_e_.

       SSaavveeWWoorrkkssppaacceeCCmmdd _(_s_t_r_i_n_g_)
              The   command   to  execute  to  perform  the  Save
              Workspace functionality.  This command defaults  to
              running  owplaces(1) which saves the currently run-
              ning clients into the  OpenWindows  startup  script
              $HOME/.openwin-init.  _D_e_f_a_u_l_t _v_a_l_u_e_:
              _o_w_p_l_a_c_e_s  _-_s_i_l_e_n_t _-_m_u_l_t_i _-_l_o_c_a_l _-_s_c_r_i_p_t _-_t_w _-_o_u_t_p_u_t
              _$_H_O_M_E_/_._o_p_e_n_w_i_n_-_i_n_i_t

       SSaavveeWWoorrkkssppaacceeTTiimmeeoouutt _(_i_n_t_e_g_e_r_)
              Number of seconds to wait while the Save  Workspace
              operation  is  in  progress.  If the Save Workspace
              command has not completed  within  this  amount  of
              time,  the  operation is considered to have failed.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _3_0_.

       SSeelleeccttDDiissppllaayyssMMeennuu _(_b_o_o_l_e_a_n_) **
              If true, pressing  the  SELECT  mouse  button  will
              bring up a menu item's sub-menu (if any) instead of
              executing the sub-menu's default  action.   _D_e_f_a_u_l_t
              _v_a_l_u_e_: _f_a_l_s_e_.

       SSeelleeccttiioonnFFuuzzzz _(_i_n_t_e_g_e_r_)
              Number  of  pixels  of  "fuzz"  to  be applied when
              selecting windows and icons by dragging a rectangle
              on  the  workspace.   Consider  an object that lies



                           25 Nov 1992                         23





olwm(1)                                                   olwm(1)


              almost entirely within the selection rectangle, but
              that  laps  outside  the rectangle by a few pixels.
              The object will be  considered  to  be  within  the
              selection  rectangle  if  it  laps outside by fewer
              than or equal to "fuzz" pixels.  _D_e_f_a_u_l_t _v_a_l_u_e_:  _1_.

       SSeelleeccttTToogggglleeSSttaacckkiinngg _(_b_o_o_l_e_a_n_)
              If  true,  double-clicking on a window will push it
              to the back instead of zooming it to and  from  its
              full size.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       SSeelleeccttWWiinnddoowwss _(_b_o_o_l_e_a_n_)
              If  false,  the SELECT mouse button will not select
              windows and icons.  Its other functions  are  unaf-
              fected.   The ADJUST mouse button can still be used
              to select windows and icons.  _D_e_f_a_u_l_t _v_a_l_u_e_:  _t_r_u_e_.

       SSeerrvveerrGGrraabbss _(_b_o_o_l_e_a_n_)
              Controls  whether oollwwmm grabs the server while menus
              and notices are up.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       SSeettIInnppuutt _(_e_n_u_m_e_r_a_t_i_o_n_) **
              Controls the input focus mode.   If  the  value  is
              "select", it means click-to-focus.  If the value is
              "followmouse",   it   means    focus-follows-mouse.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _s_e_l_e_c_t_.

       SShhoowwMMoovveeGGeeoommeettrryy _(_b_o_o_l_e_a_n_)
              Indicates  whether the geometry box should be shown
              while moving windows  and  icons.   _D_e_f_a_u_l_t  _v_a_l_u_e_:
              _f_a_l_s_e_.

       SShhoowwRReessiizzeeGGeeoommeettrryy _(_b_o_o_l_e_a_n_)
              Indicates  whether the geometry box should be shown
              while resizing windows.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       SSnnaappTTooGGrriidd _(_b_o_o_l_e_a_n_)
              Determines whether icons will snap to a  grid  when
              they are moved.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       SSttaarrttDDSSDDMM _(_b_o_o_l_e_a_n_)
              Determines  whether oollwwmm will provide the DSDM ser-
              vice.  See the section on Drag and Drop for further
              details.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       TTeexxttFFoonntt _(_f_o_n_t _n_a_m_e_)
              Font used in the text of notices.  _D_e_f_a_u_l_t_: _L_u_c_i_d_a_-
              _S_a_n_s_-_1_2_.

       TTiittlleeFFoonntt _(_f_o_n_t _n_a_m_e_)
              Font used in title bars  atop  windows  and  menus.
              _D_e_f_a_u_l_t_: _L_u_c_i_d_a_-_S_a_n_s_-_1_2 _B_o_l_d_.





                           25 Nov 1992                         24





olwm(1)                                                   olwm(1)


       TTrraannssiieennttssSSaavveeUUnnddeerr _(_b_o_o_l_e_a_n_)
              Specifies   whether  the  save-under  attribute  of
              frames of transient windows is  to  be  forced  on.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       TTrraannssiieennttssTTiittlleedd _(_b_o_o_l_e_a_n_)
              Specifies  whether  transient  windows  should have
              title bars.  Normally,  transient  windows  have  a
              title  bar and resize corners, but no window button
              or pushpin.  Setting this resource  to  false  will
              remove   the  title  bar  from  transient  windows.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       UUssee33DD _(_b_o_o_l_e_a_n_)
              Specifies whether to use 3D OPEN LOOK  when  possi-
              ble.  If false, 3D look is never used.  If true, 3D
              is used unless the display hardware cannot  support
              it.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       UUssee33DDFFrraammeess _(_b_o_o_l_e_a_n_)
              Specifies  whether  to  use a 3D look for the frame
              borders.  If true, the frames will be  given  a  3D
              look; otherwise, they have the same thick border as
              in 2D look.  Some people  prefer  the  look  of  3D
              frames,  but  it  is  more difficult to distinguish
              selected from unselected windows with  this  option
              turned on.  _D_e_f_a_u_l_t _v_a_l_u_e_: _f_a_l_s_e_.

       UUssee33DDRReessiizzee _(_b_o_o_l_e_a_n_)
              Specifies  whether the window resize corners are to
              be in the 3D look.  If false, the 2D look  is  used
              for window resize corners.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.

       WWiinnddoowwCCaacchheeSSiizzee _(_i_n_t_e_g_e_r_)
              OOllwwmm  keeps a cache of windows in order to minimize
              unnecessary window creation and  destruction.   The
              value  of  this resource specifies the size of this
              cache.  Setting this resource to zero disables  the
              window cache.  _D_e_f_a_u_l_t _v_a_l_u_e_: _5_0_0_.

       WWiinnddoowwCCoolloorr _(_c_o_l_o_r_) **
              Specifies  the color of windows.  This is the "BG1"
              color for 3D OPEN LOOK.  It is used for  the  back-
              grounds  of  windows,  menus,  and notices.  The 3D
              effect is achieved by using  highlight  and  shadow
              colors  derived  from  this  color.  _D_e_f_a_u_l_t _v_a_l_u_e_:
              _#_c_c_c_c_c_c_.  This specifies a 20% gray value.

       WWiinnddoowwMMeennuuAAcccceelleerraattoorrss _(_b_o_o_l_e_a_n_)
              Determines whether menu  accelerators  are  active.
              Used   in  conjunction  with  the  MMeennuuAAcccceelleerraattoorrss
              resource.  Both must be set to true for menu accel-
              erators to be active.  _D_e_f_a_u_l_t _v_a_l_u_e_: _t_r_u_e_.




                           25 Nov 1992                         25





olwm(1)                                                   olwm(1)


       WWoorrkkssppaacceeBBiittmmaappBBgg _(_c_o_l_o_r _s_p_e_c_i_f_i_c_a_t_i_o_n_)
              Specifies   the   background  color  used  for  the
              workspace bitmap when the  WWoorrkkssppaacceeSSttyyllee  resource
              is "tilebitmap".  _D_e_f_a_u_l_t _v_a_l_u_e_: _b_l_a_c_k_.

       WWoorrkkssppaacceeBBiittmmaappFFgg _(_c_o_l_o_r _s_p_e_c_i_f_i_c_a_t_i_o_n_)
              Specifies   the   foreground  color  used  for  the
              workspace bitmap when the  WWoorrkkssppaacceeSSttyyllee  resource
              is "tilebitmap".  _D_e_f_a_u_l_t _v_a_l_u_e_: _w_h_i_t_e_.

       WWoorrkkssppaacceeBBiittmmaappFFiillee _(_f_i_l_e_n_a_m_e_)
              Specifies a X bitmap file that will be used for the
              workspace   background   when   WorkspaceStyle   is
              "tilebitmap".   If  the filename is not a full path
              name, the following directories are searched:

                   $OPENWINHOME/etc/workspace/patterns
                   $OPENWINHOME/include/X11/include/bitmaps
                   /usr/X11/include/X11/include/bitmaps

              _D_e_f_a_u_l_t _v_a_l_u_e_: _g_r_a_y_.

       WWoorrkkssppaacceeCCoolloorr _(_c_o_l_o_r_) **
              Specifies the color for the  workspace  (root  win-
              dow).   On startup, oollwwmm will set the root window's
              background color to the  color  specified  by  this
              resource,  and  it  will  restore the default back-
              ground on shutdown.  To turn off this behavior, see
              the  description  of  the  PPaaiinnttWWoorrkkssppaaccee resource.
              _D_e_f_a_u_l_t _v_a_l_u_e_: _#_4_0_a_0_c_0_.   This  specifies  a  light
              blue  color.   _N_o_t_e_: earlier versions of oollwwmm would
              accept a bitmap file  name  as  the  value  of  the
              WWoorrkkssppaacceeCCoolloorr  resource.   This  is no longer sup-
              ported,      and      the      WWoorrkkssppaacceeBBiittmmaappFFiillee,,
              WWoorrkkssppaacceeBBiittmmaappBBgg,,  and WWoorrkkssppaacceeBBiittmmaappFFgg resources
              should be used instead.

       WWoorrkkssppaacceeSSttyyllee _(_e_n_u_m_e_r_a_t_i_o_n_)
              This controls how the workspace is painted.  If the
              value is "paintcolor", the solid color specified by
              the WWoorrkkssppaacceeCCoolloorr resource is used.  If the  value
              is  "tilebitmap",  the  workspace  is  tiled with a
              bitmap     using      the      WWoorrkkssppaacceeBBiittmmaappFFiillee,,
              WWoorrkkssppaacceeBBiittmmaappBBgg,, and WWoorrkkssppaacceeBBiittmmaappFFgg resources.
              If the value is "default", the server default root-
              weave  pattern is used.  If the value of the PPaaiinntt--
              WWoorrkkssppaaccee resource is  false,  then  all  of  these
              resources  are  ignored  and the workspace color or
              pattern is left unchanged.  _D_e_f_a_u_l_t  _v_a_l_u_e_:  _p_a_i_n_t_-
              _c_o_l_o_r

SSCCRREEEENN RREESSOOUURRCCEESS
       In  addition to the global resources described above, oollwwmm
       also uses screen-specific resources.  The first  component



                           25 Nov 1992                         26





olwm(1)                                                   olwm(1)


       of  the  resource  specification  is the trailing pathname
       component of aarrggvv[[00]].  The second component is the  screen
       number  appended  to the string `screen'.  The screens are
       numbered sequentially starting from zero.  The third  com-
       ponent  of  the  resource name is the name of the resource
       itself.  For example,

            olwm.screen1.ReverseVideo: true

       enables reverse video on screen number  1  for  oollwwmm..   To
       affect all screens, you can use resource wildcarding.  For
       example, `olwm*ReverseVideo: true' will set reverse  video
       for all screens oollwwmm manages.

       The following resources are available both globally and on
       a per-screen basis.  A screen-specific resource  overrides
       the  corresponding  global  setting for that screen.  Note
       that screen specific settings for WorkspaceColor and  Win-
       dowColor  will  only  affect  oollwwmm; this may cause clashes
       with XView clients which only use the global setting.

            Background
            BorderColor
            Foreground
            ReverseVideo
            WindowColor
            WorkspaceColor


       The following resources allow  the  selection  of  visuals
       other than the screen's default.  Available visuals may be
       listed with the xxddppyyiinnffoo(1) command.

       DDeepptthh _(_i_n_t_e_g_e_r_)
              Specify the visual depth to be used when  searching
              for visuals.  _D_e_f_a_u_l_t _v_a_l_u_e_: _n_o_n_e_.

       VViissuuaall _(_e_n_u_m_e_r_a_t_i_o_n_)
              Specify  the visual class to be used when searching
              for visuals.  Valid visual classes are  SSttaattiiccGGrraayy,
              GGrraayySSccaallee, SSttaattiiccCCoolloorr, PPsseeuuddooCCoolloorr, TTrruueeCCoolloorr, and
              DDiirreeccttCCoolloorr.  Names  are  case-sensitive.   _D_e_f_a_u_l_t
              _v_a_l_u_e_: _n_o_n_e_.

       VViissuuaallIIDD _(_i_d_)
              Specify the visual ID to be used.  Note: specifying
              a visual by its ID is not portable, as IDs may vary
              from  server to server and even from one invocation
              of a server to the next.  _D_e_f_a_u_l_t _v_a_l_u_e_: _n_o_n_e_.

MMOOUUSSEELLEESSSS NNAAVVIIGGAATTIIOONN
       OOllwwmm implements OPEN LOOK Mouseless operations.  This is a
       set  of functions bound to keys that enable one to use the
       window system entirely without a  pointing  device.   Some



                           25 Nov 1992                         27





olwm(1)                                                   olwm(1)


       Mouseless  functions  are  also  useful  for  "cross-over"
       users, who may want to use them as accelerators for mouse-
       based  operations.   The full benefits of Mouseless opera-
       tions are realized in click-to-focus  mode,  although  the
       Mouseless  operations  can still be used in focus-follows-
       mouse mode.

       To use the Mouseless functions, you must  make  sure  that
       the KKeeyybbooaarrddCCoommmmaannddss resource value is "Full".  Other set-
       tings for this resource will leave most of  the  Mouseless
       functions disabled.  For further details, see the descrip-
       tion  of  the  KKeeyybbooaarrddCCoommmmaannddss  resource  in  the  Global
       Resources  section.   Enabling  Mouseless  operation  only
       activates keyboard-based functions.  It  does  not  affect
       mouse functions in any way.

       One  can  navigate  from  window  to window using the Next
       Application, Previous Application, Next Window, and Previ-
       ous  Window  functions,  bound  by  default to Alt-n, Alt-
       Shift-n, Alt-w, and Alt-Shift-w, respectively.   (See  the
       section on Mouseless Navigation for more detailed informa-
       tion.)  You can bring up both the window and the workspace
       menu  using  Alt-m  and Alt-Shift-m, respectively.  Once a
       menu is up, you can navigate through it by using the arrow
       keys  or by pressing the first letter of the menu item you
       want to go to.  You can execute the current item by press-
       ing  Return,  or  you  can  cancel  the menu using Stop or
       Escape.

       When Mouseless navigation is turned on,  Move  and  Resize
       items will appear on the window menu.  These items provide
       an alternative technique for moving and resizing  windows.
       They  can  be invoked using the mouse, using the Mouseless
       menu navigation functions from the keyboard, or  by  using
       Menu  Accelerator keys (although they are not bound to any
       accelerator keys by default).  After selecting  either  of
       these  items,  you  will  be put into a mode where you can
       move or resize the window using keyboard  keys.   In  Move
       mode, you can use the arrow keys to move the window in the
       desired direction.  You can also hold down the Control key
       to  "jump"  the  window by a larger distance each time you
       press an arrow key.  You can press Return  to  accept  the
       new location, or you can press Escape or Stop to abort the
       move operation.

       In Resize mode, the first arrow key selects the  edge  you
       are moving, and subsequent arrow keys move that edge.  For
       example, to shrink a window from the right  (that  is,  to
       move  its  right  edge  to the left) you would first enter
       resize mode, press the right arrow key to select the right
       edge,  and then press the left arrow key to move this edge
       to the left.  As in move mode, you can hold  down  Control
       to  "jump" the edge by a greater increment.  You can press
       Return to accept the new size, and you can press Escape or



                           25 Nov 1992                         28





olwm(1)                                                   olwm(1)


       Stop to abort the resize operation.

MMEENNUU AACCCCEELLEERRAATTOORRSS
       OOllwwmm  supports  accelerator  keys for certain items on the
       Window Menu.  By default, the items for which accelerators
       are  enabled are Close (Meta-W) and Quit (Meta-Q).  Press-
       ing these key combinations will operate on the  window  or
       icon  that  has  the input focus.  Other Window Menu items
       are not bound to key combinations, but can be  bound  with
       resources.   See the Key Binding Resources section (below)
       for further information.  When a menu accelerator  key  is
       active  for  a  particular function, an indication of this
       appears at the right edge of the menu item.  Key  combina-
       tions with modifiers are displayed in a self-evident fash-
       ion, except for the Meta modifier, which is displayed as a
       diamond  mark.  (The meta keys are marked with diamonds on
       Sun keyboards.)

       The default menu accelerator bindings  may  conflict  with
       certain  popular applications (such as Emacs or the Athena
       text widget).  It is thus possible to disable menu  accel-
       erators  on  a  per-application  basis.   To  disable menu
       accelerators, add a resource of the form

            olwm.Client._c_l_a_s_s.MenuAccelerators: false

       to the resource database, where _c_l_a_s_s is the application's
       class  or  instance  name as written in the WM_CLASS prop-
       erty.  For instance,  to  disable  menu  accelerators  for
       Emacs, one would add the following

            olwm.Client.Emacs.MenuAccelerators: false

       to the ..XXddeeffaauullttss file.

KKEEYY BBIINNDDIINNGG RREESSOOUURRCCEESS
       Key  bindings  for mouseless navigation functions and menu
       accelerator keys are specified using resources.  There  is
       one  resource per function, and the value of the resources
       are the keys to which the function is bound.  The resource
       value consists of a comma-separated list of key specifica-
       tions.   Each  key  specification  consists  of  a  keysym
       optionally  followed  by  modifier  keysyms;  the modifier
       keysyms are separated by `+' signs.  For example, to  bind
       a  function to F2, control-F3, and alt-shift-F4, one would
       use the value:

            F2,F3+Control,F4+Shift+Alt


       Any keysym whose key is in the  modifier  mapping  may  be
       used  as  a  modifier.   The following can also be used as
       aliases for common modifier keysyms: SShhiifftt, LLoocckk, CCoonnttrrooll,
       CCttrrll, CCttll, MMeettaa, AAlltt, SSuuppeerr, and HHyyppeerr..



                           25 Nov 1992                         29





olwm(1)                                                   olwm(1)


       Resource  names  are  prefixed  with the trailing pathname
       component of  aarrggvv[[00]],  followed  by  KKeeyybbooaarrddCCoommmmaanndd  for
       mouseless  navigation  functions,  or  MMeennuuAAcccceelleerraattoorr for
       menu accelerator keys, followed by  one  of  the  resource
       names  from  the following list.  (Note that the KKeeyybbooaarrdd--
       CCoommmmaanndd resource component is singular, and is not  to  be
       confused  with the KKeeyybbooaarrddCCoommmmaannddss global resource name.)
       For example, the resource specification  for  setting  the
       Stop function would be:

            olwm.KeyboardCommand.Stop

       and  the  resource specification for setting the Back menu
       accelerator function would be:

            olwm.MenuAccelerator.Back


       Each item in this list is followed by its default keyboard
       binding  and  a  description  of  what  the function does.
       Items marked with an asterisk `*' involve keyboard  grabs.
       Items  not  marked  with an asterisk are active only while
       oollwwmm is in a mode, such as  when  a  menu  is  up.   Items
       marked with an exclamation point `!' are menu accelerators
       and are specified using the MMeennuuAAcccceelleerraattoorr resource  com-
       ponent  as  described  above.   Items  not  marked with an
       exclamation  point  are  considered  mouseless  navigation
       functions  and use the KKeeyybbooaarrddCCoommmmaanndd resource component.

       Most of the mouseless navigation functions that use  grabs
       are  active only when the KKeeyybbooaarrddCCoommmmaannddss resource is set
       to FFuullll..  The menu accelerator functions  all  use  grabs,
       and they are controlled by the global resources MMeennuuAAcccceell--
       eerraattoorrss and WWiinnddoowwMMeennuuAAcccceelleerraattoorrss..  For further  informa-
       tion, see the description of these resources in the Global
       Resources section.

       Stop _(_L_1_, _E_s_c_a_p_e_)
              Abort the current mode or action.

       DefaultAction _(_R_e_t_u_r_n_, _M_e_t_a_-_R_e_t_u_r_n_, _E_n_t_e_r_)
              Execute the default action for the current menu  or
              notice.

       Select _(_s_p_a_c_e_)
              Select the current button.

       Adjust _(_A_l_t_-_I_n_s_e_r_t_)
              Toggle the selected state of the current object.

       Menu _(_A_l_t_-_s_p_a_c_e_)
              Bring up a menu on the current object.





                           25 Nov 1992                         30





olwm(1)                                                   olwm(1)


       InputFocusHelp _(_?_, _C_o_n_t_r_o_l_-_?_)
              Bring up Help on the object with the input focus.

       Up _(_u_p_-_a_r_r_o_w_)
              Move up one item.

       Down _(_d_o_w_n_-_a_r_r_o_w_)
              Move down one item.

       Left _(_l_e_f_t_-_a_r_r_o_w_)
              Move left one item.

       Right _(_r_i_g_h_t_-_a_r_r_o_w_)
              Move right one item.

       JumpUp _(_C_o_n_t_r_o_l _u_p_-_a_r_r_o_w_)
              Move up ten items.

       JumpDown _(_C_o_n_t_r_o_l _d_o_w_n_-_a_r_r_o_w_)
              Move down ten items.

       JumpLeft _(_C_o_n_t_r_o_l _l_e_f_t_-_a_r_r_o_w_)
              Move left ten items.

       JumpRight _(_C_o_n_t_r_o_l _r_i_g_h_t_-_a_r_r_o_w_)
              Move right ten items.

       RowStart _(_H_o_m_e_, _R_7_)
              Move to the start of the current row.

       RowEnd _(_E_n_d_, _R_1_3_)
              Move to the end of the current row.

       DataStart _(_C_o_n_t_r_o_l_-_H_o_m_e_)
              Move to the start of the data.

       DataEnd _(_C_o_n_t_r_o_l_-_E_n_d_)
              Move to the end of the data.

       FirstControl _(_C_o_n_t_r_o_l_-_[_)
              Move to the first item.

       LastControl _(_C_o_n_t_r_o_l_-_]_)
              Move to the last item.

       NextElement _(_T_a_b_, _C_o_n_t_r_o_l_-_T_a_b_)
              Move to the next item.

       PreviousElement _(_S_h_i_f_t_-_T_a_b_, _C_o_n_t_r_o_l_-_S_h_i_f_t_-_T_a_b_)
              Move to the previous item.

       Open _(_A_l_t_-_L_7_) *
              Open the object with the input focus.




                           25 Nov 1992                         31





olwm(1)                                                   olwm(1)


       Help _(_H_e_l_p_) *
              Bring up Spot Help on the object under the pointer.

       LockColormap _(_C_o_n_t_r_o_l_-_L_2_) *
              Install the colormap of  the  subwindow  under  the
              pointer,  and  give  the colormap focus to the top-
              level window containing the pointer.  See  _C_o_l_o_r_m_a_p
              _I_n_s_t_a_l_l_a_t_i_o_n for further details.

       UnlockColormap _(_C_o_n_t_r_o_l_-_L_4_) *
              Revert  to color-follows-mouse mode, and unset col-
              ormap focus.  See _C_o_l_o_r_m_a_p _I_n_s_t_a_l_l_a_t_i_o_n for further
              details.

       Front _(_A_l_t_-_L_5_) *
              Bring the object with the input focus to the front.

       FocusToPointer _(_A_l_t_-_S_h_i_f_t_-_j_) *
              Set the focus to the window under the pointer.

       NextApp _(_A_l_t_-_n_) *
              Move the focus to the next  base  window.   Windows
              are  ordered  clockwise starting at the top.  Icons
              come after all windows, also in a  clockwise  fash-
              ion.  Order proceeds from the last icon on a screen
              to the first window of the next screen.  After  the
              last  screen,  the  order  wraps back around to the
              first screen.

       PreviousApp _(_A_l_t_-_S_h_i_f_t_-_n_) *
              Move the focus to the previous  base  window.   See
              NNeexxttAApppp  for  details  about  the  window traversal
              order.

       ToggleInput _(_A_l_t_-_t_) *
              Move the input focus to the  previous  window  that
              had the input focus.

       NextWindow _(_A_l_t_-_w_) *
              Move  to  the  next window in the family of windows
              consisting of a base window and  a  set  of  pop-up
              windows.   Windows  are ordered clockwise, starting
              at the top of the screen.

       PreviousWindow _(_A_l_t_-_S_h_i_f_t_-_w_) *
              Move to the previous window in the family  of  win-
              dows  consisting of a base window and a set of pop-
              up windows.  Windows are ordered clockwise,  start-
              ing at the top of the screen.

       TogglePin _(_M_e_t_a_-_I_n_s_e_r_t_) *
              Toggle  the state of the pin of the window with the
              input focus.




                           25 Nov 1992                         32





olwm(1)                                                   olwm(1)


       SuspendMouseless _(_A_l_t_-_z_) *
              Temporarily suspend all key grabs  associated  with
              Mouseless operation.

       ResumeMouseless _(_A_l_t_-_S_h_i_f_t_-_z_) *
              Resume grabs after temporary suspension.

       QuoteNextKey _(_A_l_t_-_q_) *
              Pass  the next key sequence to the application with
              the focus, ignoring any grabs.

       Refresh _(_n_o _b_i_n_d_i_n_g_) *!
              Repaint the window with the focus.

       Back _(_n_o _b_i_n_d_i_n_g_) *!
              Move the focus window behind other windows.

       OpenClose _(_M_e_t_a_-_W_) *!
              Toggle the open/close state of the window with  the
              focus.

       FullRestore _(_n_o _b_i_n_d_i_n_g_) *!
              Toggle  the  full-sized/normal-sized  state  of the
              window with the focus.

       Quit _(_M_e_t_a_-_Q_) *!
              Quit the window with the focus.

       Owner _(_n_o _b_i_n_d_i_n_g_) *!
              Flash the owner window of the  pop-up  window  with
              the focus.

       WorkspaceMenu _(_A_l_t_-_S_h_i_f_t_-_m_) *
              Bring up the workspace menu.

       WindowMenu _(_A_l_t_-_m_) *
              Bring  up  the  window  menu on the window with the
              focus.

       Move _(_n_o _b_i_n_d_i_n_g_) *!
              Move the window with the focus.

       Resize _(_n_o _b_i_n_d_i_n_g_) *!
              Resize the window with the focus.

       OpenClosePointer _(_L_7_) *
              Toggle the open/close state of the window  or  icon
              under the pointer.

       RaiseLower _(_L_5_) *
              Raise  the  window under the pointer if obscured by
              other windows.  Otherwise, lower the window  if  it
              obscures other windows.




                           25 Nov 1992                         33





olwm(1)                                                   olwm(1)


MMOODDIIFFIIEERR CCUUSSTTOOMMIIZZAATTIIOONN
       OOllwwmm will alter the operation of certain mouse-based func-
       tions based on the state of the modifier keys.  The  rela-
       tionship  between  the alteration and the associated modi-
       fier keys is controlled by a set of  resources.   Resource
       names are prefixed with the trailing pathname component of
       aarrggvv[[00]], followed by MMooddiiffiieerr,, followed by a resource from
       the  list  below.  For example, the resource specification
       to bind the Reduce modifier would typically be

            olwm.Modifier.Reduce

       The value of each resource is a  comma-separated  list  of
       modifier  keysyms.   Each item in this list is followed by
       its default modifier and a description of what it does.

       Constrain _(_C_o_n_t_r_o_l_)
              Constrain a move or resize operation to be only  on
              a horizontal or vertical direction.

       Ignore _(_L_o_c_k_, _N_u_m_L_o_c_k_, _m_o_d_5_, _M_o_d_e___s_w_i_t_c_h_)
              The  set of modifiers to be ignored when processing
              mouse button events.  This resource should  contain
              the set of locking modifiers, so that mouse actions
              are still interpreted properly even  while  locking
              modifiers  are  in  effect.   The  _m_o_d_5 modifier is
              included in this set because XView places  function
              keys  into  this  row in the modifier mapping table
              for use with quick-move and quick-copy  operations.

       Invert _(_S_h_i_f_t_)
              When  moving  windows, temporarily invert the sense
              of the DDrraaggWWiinnddooww resource.  When resizing  a  win-
              dow,  temporarily  move  the window as long as this
              modifier is held down.  Return to resizing when the
              modifier is released.

       Reduce _(_M_e_t_a_)
              When  moving  windows,  reduce  the amount of mouse
              motion by a factor of ten.

       SetDefault _(_C_o_n_t_r_o_l_)
              Sets the default item for a menu.

       WMGrab _(_A_l_t_)
              Using the WMGrab  modifier  allows  access  to  the
              mouse  button  functions  anywhere over the window,
              not just over the window's title bar and border.

EENNVVIIRROONNMMEENNTT
       DISPLAY
              Specifies the X11 server to which to connect.





                           25 Nov 1992                         34





olwm(1)                                                   olwm(1)


       LANG, LC_CTYPE, LC_MESSAGE, LC_TIME
              These variables specify which locale  to  use  when
              other methods of locale announcement are not avail-
              able.  (See the section on Locale Handling for more
              details.)

       OLWMMENU
              Specifies a file to use for the Workspace Menu.

       OPENWINHOME
              Specifies the location of the OpenWindows software.

FFIILLEESS
       $HOME/.openwin-menu_._l_o_c_a_l_e_n_a_m_e

       $HOME/.openwin-menu
              Contains the user-customized Workspace Menu  speci-
              fication.

       $OPENWINHOME/lib/openwin-menu._l_o_c_a_l_e_-_n_a_m_e

       $OPENWINHOME/lib/openwin-menu
              Contains  the default Workspace Menu specification.

       $HOME/.openwin-init
              Stores the command lines obtained during  the  Save
              Workspace operation.

       $OPENWINHOME/lib/app-defaults/Olwm

       $OPENWINHOME/lib/locale/_l_o_c_a_l_e_-_n_a_m_e/app-defaults/Olwm
              Specifies system-wide default resource values.

TTRRAADDEEMMAARRKKSS
       OPEN LOOK is a trademark of AT&T.
       The  X  Window  system is a trademark of the Massachusetts
       Institute of Technology.
       OpenWindows is a trademark of Sun Microsystems, Inc.

RREEFFEERREENNCCEESS
       Rosenthal, David S.H.  _I_n_t_e_r_-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n  _C_o_n_v_e_n_-
       _t_i_o_n_s _M_a_n_u_a_l _f_o_r _X_1_1_.  Copyright 1989 by the Massachusetts
       Institute of Technology.  This document is commonly  known
       as  the ICCCM.  It is an X Consortium Standard that speci-
       fies conventions to which all X11 clients must adhere.

       OPEN LOOK Graphical User Interface  Functional  Specifica-
       tion.   Copyright 1989 by Sun Microsystems, Inc.  Addison-
       Wesley Publishing Company, Inc.  ISBN 0-201-52365-5.

       OPEN LOOK Graphical User  Interface  International  Exten-
       sions Functional Specification.  Draft 1.1 (May 10, 1990).
       Copyright 1990 by Unix International.




                           25 Nov 1992                         35





olwm(1)                                                   olwm(1)


SSEEEE AALLSSOO
       ddssddmm(1),  oollwwmmssllaavvee(1),  ooppeennwwiinn(1),  oowwppllaacceess(1),  sseettlloo--
       ccaallee(3C), xxiinniitt(1), xxnneewwss(1)

NNOOTTEESS
       The  resource  names do not follow any classing structure.
       There is no general way to specify  resources  on  a  per-
       client basis.

       There is no way to reconfigure the mouse buttons.

       The  uses  of  the modifier keys described in the Modifier
       Customization section interferes with the button  bindings
       for  one- and two-button mice.  The default value of Modi-
       fier.Invert is Shift, which interferes with  using  shift-
       button1   for   ADJUST.    The   default  value  of  Modi-
       fier.Constrain is Control,  which  interferes  with  using
       control-button1  for  MENU (on one-button mice only).  One
       can  set  the   Modifier.Invert   and   Modifier.Constrain
       resources  to  null (or to other modifiers) to avoid these
       conflicts, allowing full access to ADJUST and MENU on sys-
       tems with one- and two-button mice.  There is still a fur-
       ther conflict, as the default value of Modifier.SetDefault
       is  also  Control.   Using control-button1 on a one-button
       system will bring up the menu, but  will  set  the  menu's
       default  item.  One must release the Control key after the
       menu is up in order to get  normal  menu  operation.   The
       choice of Alt as the default value for Modifier.WMGrab may
       conflict with some applications' key bindings.

       The Exit menu item on the Workspace  Menu  doesn't  really
       shut down the server.  It kills off all clients being man-
       aged by the window manager, and then it exits  the  window
       manager itself.  This works properly if some outside agent
       such as xxiinniitt(1) or xxddmm(1) is waiting for the window  man-
       ager  or  a  client  to exit.  The outside agent will take
       care of shutting down the server or reinitializing it.  If
       you've  started up the server a different way, this option
       may not work.  Instead, the server will  be  left  running
       with  no  clients  and  no window manager running, and you
       will have to login from elsewhere to kill the  server.   A
       common  cause  of  this problem is an ..xxiinniittrrcc script that
       inadvertently leaves a non-windowed application (such as a
       daemon) running in the background.  If the ..xxiinniittrrcc script
       ends with the wwaaiitt shell command, it will never terminate.
       The  fix is to change the script to either wait for a par-
       ticular process-id, or to run the daemon in a subshell:

            (daemon &)


       OOllwwmm is fairly simplistic about how it  manages  its  key-
       board  bindings.   For  example, if you bind a function to
       control-F2, oollwwmm will grab F2 with  the  Control  modifier



                           25 Nov 1992                         36





olwm(1)                                                   olwm(1)


       and  with  all  combinations of the Lock and NumLock modi-
       fiers.  If another locking modifier is in  effect,  oollwwmm's
       passive  grab will not be activated, and thus the function
       will not work.

       OOllwwmm cannot manage multiple locales at one time, therefore
       all clients should be running in the same locale.  The "C"
       locale is  the  exception.   Applications  using  the  "C"
       locale (such as non-internationalized applications) can be
       mixed with applications using one other locale.

       OOllwwmm does not handle different sizes of  the  glyph  fonts
       well.   Each  locale  can  define a different size for the
       default font (for example, the default glyph font size  is
       12  for  the  "C"  locale  and  is  14  for the "japanese"
       locale).  OOllwwmm does not re-position the window decorations
       after  switching  locale, therefore the window decorations
       may appear to be wrong.  To remedy this problem partially,
       oollwwmm  will  not  change  the font when locale is switching
       from non-"C" locale to the "C" locale.

       There is no input focus feedback for non-rectangular  win-
       dows.   The title string of non-rectangular windows cannot
       be displayed.  Non-rectangular icon windows are  not  sup-
       ported.

       OOllwwmm   will  not  dynamically  track  screen-specific  and
       client-specific resources.  Changes to  global  resources,
       key  binding resources, and modifier resources are applied
       dynamically.

       The interaction of the  AAuuttooCCoolloorrFFooccuuss,  CCoolloorrFFooccuussLLoocckkeedd,
       and  CCoolloorrTTrraacckkssIInnppuuttFFooccuuss resources and the color locking
       and unlocking keys is overly complex.

       Changing the Display Language locale  setting  or  editing
       the  menu  specification file will cause oollwwmm to unpin any
       menus that were pinned at the time.

       Resources that specify time values use inconsistent units.
       Some resources are in tenths of a second, some are in mil-
       liseconds, and some are in microseconds.















                           25 Nov 1992                         37


