xenial (1) olwm.1olvwm.gz

Provided by: olvwm_4.4.3.2p1.4-28.1_amd64 bug

NAME

       olwm - OPEN LOOK window manager for OpenWindows

SYNOPSIS

       olwm [ options ]

DESCRIPTION

       olwm  is  a  window manager for the X Window System that implements parts of the OPEN LOOK graphical user
       interface.  It is the standard window manager for Sun's OpenWindows product, but it  will  work  properly
       with any X11 system.

OPTIONS

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

       -2d    Use two-dimensional look.  This is the default for monochrome systems.

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

       -bd,  -bordercolor
              Specifies the border color.  See the description of the BorderColor resource.

       -bg,  -background
              Specifies the background color.  See the description of the Background resource.

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

       -depth depth
              Specifies  the  depth  of  the  visual  in which olwm is to run.  See the discussion in the Screen
              Resources section.

       -display display-string
              Specify the name of the display to manage.  Overrides the DISPLAY environment  variable,  if  any.
              In  addition,  the display string is exported to olwm's environment, so processes forked from olwm
              will inherit this value.

       -f,  -follow
              Use focus-follows-mouse mode.  Default mode is click-to-focus.

       -fn font-name,  -font  font-name
              Set the font for window titles.

       -fg,  -foreground
              Specifies the foreground color.  See the description of the ForegroundColor resource.

       -multi Manage windows on all screens that a display supports.  This is the default.

       -name resource-name
              Use resource-name to look up resources in the resource database.

       -xrm resource-string
              Specify resources on the command-line.  Resources specified here will override resources found  in
              resource files.

       -single
              Manage  windows  for  a  single  screen  only, using the default screen for the specified display.
              Overrides the -multi option.

       -syncpid process-id
              When olwm has completed its initialization, it will send a signal (SIGALRM by default) to process-
              id.  The signal will be sent only if this option is present.  This is useful for running olwm from
              shell scripts (such as .xinitrc) in such a way that the  script  waits  for  olwm  to  finish  its
              initialization, while leaving olwm as a child process of the shell script.  This can be done using
              the following sh(1) construct:

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

       -syncsignal signal
              Specifies the signal to send instead of SIGALRM.   The  signal  is  specified  as  a  number,  not
              symbolically.

       -visual visual-class
              Specifies  the  class  of  the  visual  in which olwm is to run.  See the discussion in the Screen
              Resources section.

DEBUGGING OPTIONS

       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.

       -all   Print a message for every event received.

       -debug Equivalent to turning on all debugging options.

       -orphans
              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.

       -synchronize
              Run the window manager in synchronous mode.

INTERNATIONALIZATION OPTIONS

       -basiclocale locale-name
              Specify  the  basic  OPEN  LOOK locale category setting.  This category will be the base for other
              locale categories, therefore there are certain restrictions applied  to  other  locale  categories
              (see the following locale handling sections).

       -displaylang locale-name
              Specify  the  display  language  OPEN LOOK locale category.  This category affects the contents of
              workspace menu, window menu and notice messages.

       -numeric locale-name
              Specify the numeric format OPEN LOOK locale category.  This category affects  the  numeric  format
              displayed in any message that contains numerics.

LOCALE HANDLING

       Locale  is  the language and cultural conventions used in the program.  Locale will control the language-
       dependent part of olwm's behavior.  The OPEN LOOK international extensions have defined several OPEN LOOK
       locale categories as follows:

       Basic Locale
              This  is  the  basic  setting  for  the entire locale mechanism.  This category specifies internal
              character handling behavior.

       Display Language
              This category specifies the  language  used  for  displaying  menus,  notice  messages  and  error
              messages.

       Input Language
              This  category  specifies  the language used for text input.  This category has no affect on olwm,
              because it does not accept text input from the keyboard.

       Date Format
              This category specifies the format of date and time.  This category has no affect on olwm, because
              it does not display any date and time information.

       Numeric Format
              This category specifies the format of displayed numeric data.

       Since  the  Basic  Locale  setting defines the character handling of olwm, certain restrictions have been
       placed on combining the locale category settings.

       1. If basic setting is set to other than "C" locale, then all other locale categories must be the same as
          basic setting or "C".

       2. If basic setting is set to "C" locale, then all other locale categories must be in "C" locale.

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

       1. Command line options (such as -basiclocale).

       2. by resource database.

       3. setlocale(3) function defaults (for example: LANG environment variable).

       If command line options are not used to specify locale  settings,  olwm  will  pick  up  the  new  locale
       settings  from  workspace property (per changes to the resource database); and change the locale settings
       dynamically (for example, to change the language of workspace and window menus).   All  pinned  workspace
       menus will be unpinned during this locale switching operation.

INPUT FOCUS

       The input focus

       is  the  window  that  will  receive  keystrokes.   olwm  has  two different input focus modes, which are
       different ways of transferring the input focus from one window to another.  By default, olwm 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 mouse 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.

       olwm has another focus mode called "focus-follows-mouse."  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 mouse 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 subwindow, 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.

MOUSE BUTTONS

       OPEN  LOOK defines three mouse button functions: SELECT, ADJUST, and MENU.  These functions are mapped to
       mouse buttons 1, 2, and 3, respectively.  On systems with only two mouse buttons, the MENU  function  can
       be  obtained  by  pressing buttons 1 and 2 simultaneously.  This technique is referred to as mouse button
       chording.  The exact behavior of each of these functions depends on what object is under the pointer.

MANIPULATING WINDOWS AND ICONS

       Window Title Bar and Borders.

       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  to be either vertical or horizontal, depending on whether you've moved farther in a vertical
       or horizontal direction.  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  several
       windows and icons.  Pressing MENU will bring up the window menu.  See the Window Menu section for further
       details.  If the Alt 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 WMGrab resource in the section on Modifier Customization.

       Resize Corners.

       You can resize a window by pressing the left mouse button over any of the resize corners and dragging  it
       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  contrained  to  resize  vertically  or
       horizontally,  depending  on  whether  you've  moved  the  mouse  farther  in  the horizontal or vertical
       direction.

       Window Button.

       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.

       Pushpin.

       OPEN LOOK pop-up windows have a pushpin instead of a window button.  If the pushpin is out of  its  hole,
       pressing  a  command  button within the window will cause the window to be taken down ("dismissed") after
       the command is executed.  If you click SELECT on the pushpin, it will move into its hole.  In this state,
       pressing  a  command button will execute the command without dismissing the window.  Clicking SELECT over
       the pin will pull it out of the hold.  This will dismiss the window without executing any commands.  Some
       windows come up with the pin already in the hole.

       Icons.

       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.

NONRECTANGULAR WINDOWS

       The X11 Non-Rectangular Window Shape Extension (commonly referred  to  simply  as  the  Shape  extension)
       allows  windows  to  have  arbitrary shapes.  Olwm 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 Modifier 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.

SELECTIONS ON THE WORKSPACE

       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 operated 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.

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

       Programs
              This button has a sub-menu that allows you to invoke applications.  The default Programs  sub-menu
              contains  all of the programs in the OpenWindows DeskSet.  However, users typically customize this
              menu to contain many more programs and to contain  nested  submenus.   See  the  section  on  Menu
              Customization for further information.

       Utilities
              This  button  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.

       Properties...
              This item brings up the Workspace Properties window,  which  allows  you  to  view  and  customize
              settings of the OpenWindows environment.

       Help...
              Brings up the table of contents of the Help Handbooks.

       Desktop Intro...
              Brings up a tutorial introduction to the Sun Desktop.

       Exit   Shuts down all applications and exits the window system.  A confirmation notice is popped up first
              to give you a chance to cancel the operation.

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

       Close  Close  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 the  menu  on  an
              icon.

       Full Size
              Expand  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.

       Move   Starts the keyboard-based form of moving the window.  Appears only if OPEN LOOK Mouseless Mode  is
              enabled.

       Resize Starts  the  keyboard-based form of resizing the window.  Appears only if OPEN LOOK Mouseless Mode
              is enabled.

       Back   Move the window behind all other windows.

       Refresh
              Clear and redisplay the window.

       Quit   Kill the program running in the window and remove the window.  If the application has  elected  to
              participate  in the WM_DELETE_WINDOW protocol, olwm 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:

       Dismiss
              Causes  the  window to be dismissed.  This button has a submenu with two items: This Window, which
              dismisses just this window, and All Pop-ups, which dismisses all  pop-up  windows  owned  by  this
              application.

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

       You  can  customize  olwm's Workspace Menu by putting a menu description into a file that olwm will read.
       When it starts up, olwm 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, olwm will then look in the file named ".openwin-
       menu" in your home directory.  If this file is not present or is unreadable, olwm will fall back  on  the
       system  default  menu file.  If, for some reason, the system default menu file cannot be found, olwm 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 example,  if  the  display  language
       local  is  "japanese",  the  file  ".openwin-menu.japanese" will take precedence over the file ".openwin-
       menu".

       Olwm 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 AutoReReadMenuFile resource.

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

       The menu specification language has a number of keywords, all of which are in  all  upper  case  letters.
       The  keywords  are  not  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
       leading whitespace) is considered to be a command.  It is executed by sending it  to  sh(1).   Any  shell
       metacharacters  will  be  passed  through  to  the  shell  unchanged.  A line containing only the keyword
       "SEPARATOR" will add extra space before the next item.

       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 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.   To  make  a  sub-menu pinnable, add the special keyword "PIN" after the END keyword on the line
       that ends the sub-menu definition.

       A sub-menu can be specified in a different file by putting the  pathname  of  the  file  after  the  MENU
       keyword.   In  this  case,  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.

       By  default,  the  label in a menu button is used as the title of the submenu.  This can be overridden by
       specifying a line that has the special keyword TITLE in the command 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.

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

       BACK_SELN
              Move the selected windows and icons behind other windows.

       EXIT
              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 DragWindow resource.

       FLIPFOCUS
              Toggle the state of the SetInput 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.

       POSTSCRIPT
              Open up a connection to NeWS using psh(1) and send the rest of the line to it.

       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.  Olwm will start a complete
              search  for  a  menu file (as described in the Menu Customization section) and use the first valid
              file it finds.

       RESTART
              Restart the window manager by issuing an exec(2) on  argv.   This  shouldn't  affect  any  running
              applications, 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
              "owplaces -silent -multi -script -output $HOME/.openwin-init".

       WMEXIT Exit the window manager without killing any applications.

       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

COLORMAP INSTALLATION

       Olwm 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 corresponding modes for input focus.  However, colormap focus mode can be  completely  independent
       of  input  focus.   The mode in which the system starts up is determined by the ColorFocusLocked resource
       (see the Resources section below).

       Olwm 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  specified  other  windows  in a
       WM_COLORMAP_WINDOWS property, these windows are included in the set as well.

       In color-follows-mouse mode, olwm keeps track of the 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 colormap 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 changing.  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, a particular window
       is considered to have the colormap focus.  When a window has the colormap focus, colormaps  will  not  be
       installed  and  uninstalled  based  on  pointer  motion.  If a client program changes the contents of the
       WM_COLORMAP_WINDOWS property on the top-level window with  the  colormap  focus,  olwm  will  respond  by
       installing  the  colormap of the first window named in this property.  In this way, the application whose
       window has the colormap focus  can  control  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, olwm will always install the colormap of the top-level window.

       The colormap focus may be given to a window in one of several ways.  The user  can  assign  the  colormap
       focus  to  a  window  by  pressing  the  Color-Lock  key  while  the  pointer is over the window.  If the
       AutoColorFocus resource is set, new windows will be given  the  colormap  focus  automatically.   If  the
       ColorTracksInputFocus resource is set, the colormap focus will always be given to the window that has the
       input focus.

       In addition to setting the colormap focus, the Color-Lock key has  some  additional  effects.   When  you
       press the Color-Lock key, if the pointer is within a subwindow named in the WM_COLORMAP_WINDOWS property,
       that subwindow's colormap will be installed.   If  the  pointer  isn't  within  a  window  named  in  the
       WM_COLORMAP_WINDOWS  property,  or if the pointer is over the window title bar or border, the colormap of
       the first entry of the WM_COLORMAP_WINDOWS property will be installed.  You can use the Color-Lock key to
       install  the  colormap  of  a  particular subwindow no matter where it resides in the WM_COLORMAP_WINDOWS
       list.  If there is no WM_COLORMAP_WINDOWS property, pressing the Color-Lock key will simply  install  the
       colormap of the top-level window.

       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 will 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.

SPOT HELP

       Olwm  provides  spot  help  for  frames,  icons,  the  Workspace and Window menus, window buttons, resize
       corners, pushpins, and the Workspace itself.  This is done via a separate  slave  program,  olwmslave(1).
       The  slave  program is forked automatically when olwm starts up.  The forking of the slave program can be
       controlled by the RunSlaveProcess resource.

MULTIPLE SCREENS

       By default, olwm 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 .xinitrc script to  start  multiple  instances  of
       olwm,  one  for  each  screen.   These modifications are no longer necessary.  The default Xinitrc (which
       contains a single invocation of olwm) works for both single and multiple screen situations.

GLOBAL RESOURCES

       Global resources in olwm consist of two resource components.  The first component in the resource name is
       taken from the trailing pathname component of argv[0].  This value is typically `olwm'.  This name can be
       altered by using the -name 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
       AutoColorFocus attribute, one would use "olwm.AutoColorFocus" as the resource specification.

       Some resources are also interpreted by XView (see XView(7)) and  are  set  by  the  Workspace  Properties
       program (see props(1)).  For these resources, olwm will also accept the string `OpenWindows' as the first
       resource component.  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 showrgb(1)) and explicit red, green, and blue values in hexadecimal, preceded by a `#'.
       For example, a bright magenta would be specified with "#ff00ff".

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

       AutoColorFocus (boolean)
              Indicates  whether  newly appearing windows are to be given the colormap focus automatically.  See
              the section on Colormap Installation for further details.  Default value: false.

       AutoInputFocus (boolean)
              Indicates whether newly appearing windows are to be given the input focus automatically.   Default
              value: false.

       AutoRaise (boolean)
              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
              AutoRaiseDelay resource is set to a reasonable value.  Default value: false.

       AutoRaiseDelay (integer)
              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 AutoRaise resource  is  true.   Default
              value: 0.

       AutoReReadMenuFile (boolean)
              Specifies whether the menu file is to be re-read whenever it changes.  Default value: true.

       Background (color)
              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  XView(7)).   This
              resource is also distinct from the WindowColor resource.  Default value: white.

       BasicLocale (locale name)
              Specifies  the  basic  OPEN  LOOK locale category setting.  See the section on Locale Handling for
              more details.

       Beep (enumeration) *
              Specifies the circumstances under which olwm should beep.   Permissible  values  are  the  strings
              "always", "never", and "notices".  The string "never" means that olwm should never beep, "notices"
              means that olwm should beep only when a notice appears, and "always" means  that  olwm  will  beep
              whenever it is appropriate.  Default value: always.

       BorderColor (color)
              Specifies the color used for window and icon borders.  Default value: black.

       ButtonFont (font name)
              Font to be used for buttons in menus and notices.  Default value: Lucida-Sans.

       ClickMoveThreshold (integer)
              This  value  is  used when bringing up a menu.  If the mouse 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.  Default value: 5.

       ColorTracksInputFocus (boolean)
              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 Installation for further  details.   Default  value:
              false.

       ColorFocusLocked (boolean)
              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 mouse is kept  installed.   See
              the section on Colormap Installation for further details.  Default value: false.

       CursorFont (font name)
              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.  Default value:
              -sun-open look cursor-*-*-*-*-*-120-*-*-*-*-*-*.

       DefaultIconImage (filename)
              Specifies a file containing a bitmap to be used as the default icon image.

       DefaultIconMask (filename)
              Specifies a file containing a bitmap to be used as the default icon mask.

       DefaultTitle (string)
              Specifies the string to be used in the title bar of windows that have not provided a string in the
              WM_NAME property.  Default value: No Name.

       DisplayLang (locale name)
              Specifies the display language OPEN LOOK locale category.  See the section on Locale Handling  for
              more details.

       DragRightDistance (integer) *
              The  number  of  pixels you must drag the mouse to the right in a menu item to bring up a submenu.
              The submenu always comes up when you move  over  the  menu  mark  (the  right-pointing  triangle),
              regardless of the drag-right distance.  Default value: 100.

       DragThreshold (integer) *
              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.  Default value: 5.

       DragWindow (boolean)
              If  true, drags the entire image of the window when you move it.  Otherwise, just drags the window
              outline.  Default value: false.

       EdgeMoveThreshold (integer)
              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  window  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.  Default value: 10.

       FlashCount (integer)
              Number  of  times  the  title  bar  is flashed when the "Owners?" menu item is activated.  Default
              value: 6.

       FlashTime (integer)
              Amount of time, in microseconds, for which the title bar is flashed when the "Owner?" menu item is
              activated.  Default value: 100000.

       FocusLenience (boolean)
              If  this  is  set  to true, olwm 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.  Default value: false.

       Foreground (color)
              Specifies  the foreground color.  This color is used mainly for the text of window and icon titles
              and in menus.  Default value: black.

       GlyphFont (font name)
              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.
              Default value: -sun-open look glyph-*-*-*-*-*-120-*-*-*-*-*-*.

       IconFlashCount (integer)
              Number of times to flash the open/close "zoom" lines.  Default value: 3.

       IconFlashOffTime (integer)
              Amount of time to pause while open/close "zoom" lines are not visible.  Default value: 1.

       IconFlashOnTime (integer)
              Amount of time to pause while open/close "zoom" lines are visible.  Default value: 20000.

       IconFont (font name)
              Font used for icon names.  Default: Lucida-Sans.

       IconLocation (enumeration) *
              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.
              Default value: top.

       InvertFocusHighlighting (boolean)
              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.  Default value:
              false.

       KeepTransientsAbove (boolean)
              Specifies whether olwm should attempt to keep transient windows above their owner window.  Default
              value: true.

       KeyboardCommands (enumeration) *
              Permissible  values  for  this resource are SunView1, Basic, and Full.  Values are case-sensitive.
              In Full mode, all OPEN LOOK Mouseless commands implemented by the window manager are active.   See
              the  section  on  Key  Binding  for further information.  In Basic mode, the keys active are Open,
              Front, Help, and the colormap keys.  In SunView1 mode, the only keys active are  Open  and  Front.
              Default value: Basic.

       MinimalDecor (list of strings)
              Specifies  a  list  of  windows  that  are  to be decorated 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 applications
              class or instance name, as passed in the WM_CLASS property.  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 calculator 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  -name
              option on the command line.  Default value: (null).

       MouseChordTimeout (integer)
              Specifies  the  amount  of  time,  in  milliseconds, that olwm is to wait for subsequent events to
              disambiguate chorded mouse button event sequences.

       MultiClickTimeout (integer) *
              The time, in tenths of a second, that  differentiates  a  double-click  from  two  single  clicks.
              Default value: 5.

       Numeric (locale name)
              Specifies  the  numeric  format OPEN LOOK locale category.  See the section on Locale Handling for
              more details.

       PaintWorkspace (boolean)
              If true, olwm will use the WorkspaceColor resource to set the workspace (root  window)  background
              color.   If  false, olwm will not change the root window background.  This is useful If you prefer
              to set your own workspace color using xsetroot(1) or a similar program.  Default value: true.

       PPositionCompat (boolean)
              Turns on backward compatibility for older applications that have a habit  of  always  setting  the
              PPosition  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.
              Default value: false.

       PopupJumpCursor (boolean) *
              Specifies whether to warp the cursor to popup windows.  Default value: true.

       RaiseOnActivate (boolean)
              Specifies whether a window is to be raised when it is activated via a Mouseless command.   Default
              value: true.

       RefreshRecursively (boolean)
              Determines  how the Refresh menu items on the window and workspace menus operate.  If the value is
              true, olwm will walk the window hierarchy and send exposure  events  to  every  window.   This  is
              useful  for  refreshing  windows  that have backing store.  If the value is false, olwm will map a
              window and then unmap it, causing all windows underneath that do not have backing  store  get  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 long latency.  Default value: true.

       ReverseVideo (boolean)
              If  true, reverses the sense of black and white on monochrome screens.  Ignored for color screens.
              Default value: false.

       RubberBandThickness (integer)
              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 rectangle on the root, and when a window is moved and
              the value of the DragWindow resource is false.

       RunSlaveProcess (boolean)
              If false, disables the running of olwmslave(1) at startup time.   If  the  slave  process  is  not
              running,  Spot  Help  will  not  be available on objects owned by olwm such as pushpins and resize
              corners.  Default value: true.

       SaveWorkspaceTimeout (integer)
              Number of seconds to wait while the Save Workspace operation is in progress.  If all  applications
              haven't  responded  with this amount of time, the operation is considered to have failed.  Default
              value: 30.

       SelectDisplaysMenu (boolean) *
              If true, pressing the SELECT mouse button will bring up a menu item's submenu (if any) instead  of
              executing the submenu's default action.  Default value: false.

       SelectionFuzz (integer)
              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 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.   Default
              value: 1.

       SelectToggleStacking (boolean)
              If  true,  double-clicking  on a window will push it to the back instead of zooming it to its full
              size.  Default value: false.

       SelectWindows (boolean)
              If false, the SELECT mouse button will not select windows and  icons.   Its  other  functions  are
              unaffected.   The  ADJUST  mouse  button  can  still be used to select windows and icons.  Default
              value: true.

       ServerGrabs (boolean)
              Controls whether olwm grabs the server while menus and notices are up.  Default value: true.

       SetInput (enumeration) *
              This 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.  Default value: select.

       ShowMoveGeometry (boolean)
              Indicates whether the geometry box should be shown while moving windows and icons.  Default value:
              false.

       ShowResizeGeometry (boolean)
              Indicates whether the geometry box should be shown while resizing windows.  Default value: false.

       SnapToGrid (boolean)
              Determines whether icons will snap to a grid when they are moved.  Default value: false.

       TextFont (font name)
              Font used in the text of notices.  Default: Lucida-Sans.

       TitleFont (font name)
              Font used in title bars atop windows and menus.  Default: Lucida-Sans Bold.

       TransientsSaveUnder (boolean)
              Specifies whether the save-under attribute of transient windows  is  to  be  forced  on.   Default
              value: true.

       TransientsTitled (boolean)
              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.  Default value: true.

       Use3D (boolean)
              Specifies  whether  to use 3D OPEN LOOK when possible.  If false, 3D look is never used.  If true,
              3D is used unless the display hardware cannot support it.  Default value: true.

       Use3DFrames (boolean)
              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.  Default value: false.

       Use3DResize (boolean)
              Specifies whether the window resize corners are to be in the 2D or 3D look.  Default value: false.

       WindowColor (color) *
              Specify  the  color  of  windows.   This  is the "BG1" color for 3D OPEN LOOK.  It is used for the
              backgrounds of windows, menus, and notices.  Other the 3D effect is achieved  by  using  highlight
              and shadow colors derived from this color.  Default value: #ccc.

       This specifies a 20% gray value.

       WorkspaceColor (color) *
              Specify  the  color  for the workspace (root window).  On startup, olwm will set the root window's
              background color to the color specified  by  this  resource,  and  it  will  restore  the  deafult
              background  on  shutdown.   To  turn  off this behavior, see the description of the PaintWorkspace
              resource.  Default value: #40a0c0.

SCREEN RESOURCES

       In addition to the global resources described above, olwm also uses screen-specific resources.  The first
       component  of  the  resource  specification  is  the  trailing pathname component of argv[0].  The second
       component is the screen number appended to the string `screen'.  The third component 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  olwm.   To  affect all screens, you can use resource
       wildcarding.  For example, `olwm*ReverseVideo: true' will set reverse video for all screens olwm manages.

       The following resources are available both  globally  and  on  a  per-screen  basis.   A  screen-specific
       resource  overrides the corresopnding global setting for that screen.  Note that screen specific settings
       for WorkspaceColor and WindowColor will only affect olwm; 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 xdpyinfo(1) command.

       Depth (integer)
              Specify the visual depth to be used when searching for visuals.  Default value: none.

       Visual (enumeration)
              Specify the visual class to be  used  when  searching  for  visuals.   Valid  visual  classes  are
              StaticGray,  GrayScale,  StaticColor,  PseudoColor,  TrueColor,  and DirectColor.  Names are case-
              sensitive.  Default value: none.

       VisualID (id)
              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.  Default value:
              none.

MOUSELESS OPERATION

       Olwm implements OPEN LOOK Mouseless operation.  This is a set of functions bound to keys that enable  one
       to  use  the  window system entirely without a pointing device.  Some Mouseless functions are also useful
       for "cross-over" users, who may want to use them as accelerators for mouse-based operations.

       One can navigate from window to window using the Next Application, Previous Application, Next Window, and
       Previous  Window functions, bound by default to Alt-n, Alt-Shift-n, Alt-w, and Alt-Shift-w, respectively.
       (See the section on Key Binding for more detailed information.)  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 pressing Return, or you can cancel the menu using Stop or Escape.

       You  can also move and resize windows use Mouseless functions.  This can be accomplished by selecting the
       Move or Resize items on the window menu.  (Keyboard acclerators for these items are  Alt-F6  and  Alt-F7,
       respectively.)   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.   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 it right  edge  to
       the  left)  you would first enter resize mode using Alt-F7, press the right arrow key to select the right
       edge, and then press the left arrow key to move the 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 or
       location, and you can press Escape or Stop to abort the move or resize operation.

KEY BINDING

       Key bindings 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 specifications.  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: Shift, Lock, Control, Ctrl, Ctl, Meta, Alt, Super, and
       Hyper.

       Resource names are prefixed with the trailing pathname component of argv[0], followed by  KeyboardCommand
       (note  that  this  is  singular,  not  to  be confused with the KeyboardCommands resource), followed by a
       resource from the following list.  For example, the resource specification for setting the Stop  function
       would typically be:

            olwm.KeyboardCommand.Stop

       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.  Other items are active only while  olwm
       is  in a mode, such as when a menu is up.  Note: most of the functions that require grabs are active only
       when the KeyboardCommands resource is set to Full.  See the description of this resource in  the  section
       on Global Resources.

       Stop (L1, Escape)
              Abort the current mode or action.

       DefaultAction (Return, Meta-Return, Enter)
              Execute the default action for the current menu or notice.

       Select (space)
              Select the current button.

       Adjust (Alt-Insert)
              Toggle the selected state of the current object.

       Menu (Alt-space)
              Bring up a menu on the current object.

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

       Up (up-arrow)
              Move up one item.

       Down (down-arrow)
              Move down one item.

       Left (left-arrow)
              Move left one item.

       Right (right-arrow)
              Move right one item.

       JumpUp (Control up-arrow)
              Move up ten items.

       JumpDown (Control down-arrow)
              Move down ten items.

       JumpLeft (Control left-arrow)
              Move left ten items.

       JumpRight (Control right-arrow)
              Move right ten items.

       RowStart (Home, R7)
              Move to the start of the current row.

       RowEnd (End, R13)
              Move to the end of the current row.

       DataStart (Control-Home)
              Move to the start of the data.

       DataEnd (Control-End)
              Move to the end of the data.

       FirstControl (Control-[)
              Move to the first item.

       LastControl (Control-])
              Move to the last item.

       NextElement (Tab, Control-Tab)
              Move to the next item.

       PreviousElement (Shift-Tab, Control-Shift-Tab)
              Move to the previous item.

       Open (Alt-L7) *
              Open the object with the input focus.

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

       LockColormap (Control-L2) *
              Install  the  colormap of the subwindow under the pointer, and give the colormap focus to the top-
              level window containing the pointer.  See Colormap Installation

       for further details.

       UnlockColormap (Control-L4) *
              Revert to color-follows-mouse mode, and unset colormap focus.  See Colormap Installation

       for further details.

       Front (Alt-L5) *
              Bring the object with the input focus to the front.

       FocusToPointer (Alt-Shift-j) *
              Set the focus to the window under the pointer.

       NextApp (Alt-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 fashion.  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 (Alt-Shift-n) *
              Move  the  focus  to the previous base window.  See NextApp for details about the window traversal
              order.

       ToggleInput (Alt-t) *
              Move the input focus to the previous window that had the input focus.

       NextWindow (Alt-w) *
              Move to the next window in the family of windows consisting of a base window and a set of  popups.
              Windows are ordered clockwise, starting at the top of the screen.

       PreviousWindow (Alt-Shift-w) *
              Move  to  the  previous  window  in the family of windows consisting of a base window and a set of
              popups.  Windows are ordered clockwise, starting at the top of the screen.

       TogglePin (Meta-Insert) *
              Toggle the state of the pin of the window with the input focus.

       SuspendMouseless (Alt-z) *
              Temporarily suspend all key grabs associated with Mouseless operation.

       ResumeMouseless (Alt-Shift-z) *
              Resume grabs after temporary suspension.

       QuoteNextKey (Alt-q) *
              Pass the next key sequence to the application with the focus, ignoring any grabs.

       Refresh (Alt-F8) *
              Repaint the window with the focus.

       Back (Alt-F5) *
              Move the focus window behind other windows.

       OpenClose (Alt-F2) *
              Toggle the open/clos state of the window with the focus.

       FullRestore (Alt-F3) *
              Toggle the full-sized/normal-sized state of the window with the focus.

       Quit (Alt-F9) *
              Quit the window with the focus.

       Owner (Alt-F10) *
              Flash the owner of the popup window with the focus.

       WorkspaceMenu (Alt-Shift-m) *
              Bring up the workspace menu.

       WindowMenu (Alt-m) *
              Bring up the window menu on the window with the focus.

       Move (Alt-F6) *
              Move the window with the focus.

       Resize (Alt-F7) *
              Resize the window with the focus.

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

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

MODIFIER CUSTOMIZATION

       Olwm  will  alter the operation of certain mouse-based functions based on the state of the modifier keys.
       The relationship between the alteration and the associated modifier  keys  is  controlled  by  a  set  of
       resources.   Resource  names  are  prefixed  with the trailing pathname component of argv[0], followed by
       Modifier, 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 (Control)
              Constrain a move or resize operation to be only on a horizontal or vertical direction.

       Ignore (Lock, NumLock, mod5, Mode_switch)
              The set of modifiers to be ignored when processing mouse 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.

       Invert (Shift)
              When moving windows, temporarily invert the sense of the DragWindow  resource.   When  resizing  a
              window,  temporarily  move  the  window as long as this modifier is held down.  Return to resizing
              when the modifier is released.

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

       SetDefault (Control)
              Sets the default item for a menu.

       WMGrab (Alt)
              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.

ENVIRONMENT

       DISPLAY
              Specifies the X11 server to which to connect.

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

       OLWMMENU
              Specifies a file to use for the Workspace Menu.

FILES

       $HOME/.openwin-menu.localename

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

       $OPENWINHOME/lib/openwin-menu.localename

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

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

TRADEMARKS

       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.

REFERENCES

       Rosenthal, David S.H.  Inter-Client Communication Conventions Manual for  X11.   Copyright  1989  by  the
       Massachusetts  Institute  of  Technology.   This  document  is  commonly  known as the ICCCM.  It is an X
       Consortium Standard that specifies conventions to which all X11 clients must adhere.

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

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

       setlocale(3).

BUGS

       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.  This makes it impossible to use olwm on a system that
       has a one-button mouse with no provision for simulating a second or third mouse button.  (It is  possible
       to use olwm with a two-button mouse.  See the section on Mouse Buttons.)

       The  Exit  menu item on the Workspace Menu doesn't really shut down the server.  It kills off all clients
       being managed by the window manager, and then it exits the window manager itself.  This works properly if
       some outside agent such as xinit(1) or xdm(1) is waiting for the window manager 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.   An
       alternative for users of X11/NeWS is to add the following entry to the root menu:

            Exit POSTSCRIPT shutdownserver
       sp
       This will shut down the server immediately, with no confirmation whatsoever.

       Olwm  is  fairly  simplistic  about  how  it  manages  its keyboard bindings.  For example, if you bind a
       function to control-F2, olwm will grab F2 with the Control modifier and with all combinations of the Lock
       and  NumLock  modifiers.   If  another  locking  modifier  is  in effect, olwm's passive grab will not be
       activated, and thus the function will not work.

       Olwm 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.

       Olwm 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).  Olwm does not re-position the window decorations after switching  locale,  therefore
       the  window  decorations  may appear to be wrong.  To remedy this problem partially, olwm will not change
       the font when locale is switching from non-"C" locale to the "C" locale (fonts for  non-"C"  locales  are
       always supersets of the font for "C" locale).

       There  is no input focus feedback for nonrectangular windows.  The title string of nonrectangular windows
       cannot be displayed.

       Olwm will not dynamically track screen-specific resources.  Only changes to global resources are applied.

       The interaction of the AutoColorFocus, ColorFocusLocked,  and  ColorTracksInputFocus  resources  and  the
       color locking and unlocking keys is overly complex.

                                                  6 August 1991                                     olwm(1olvwm)