Provided by: olvwm_4.4.3.2p1.4-28_i386 bug

NAME

       olvwm - OPEN LOOK virtual window manager for X11 and OpenWindows

SYNOPSIS

       olvwm [ options ]

DESCRIPTION

       olvwm  is  a  virtual  window  manager  for  the  X  Window System that
       implements parts of the OPEN  LOOK  graphical  user  interface.   olvwm
       differs  from  olwm  in  that  olvwm manages a virtual desktop which is
       larger than the actual screen.  However, olvwm  is  equivalent  in  all
       other  respects to, and supports all the features of olwm.  This manual
       page discusses only the changes between olvwm and olwm, most  of  which
       deal  specifically  with  the virtual desktop.  For details on how olwm
       operates, including its host of options, see olwm(1).

OPTIONS

       There is one new option to olvwm.

       -allowSynthetic
              Allow the receipt of synthetic events.  Note that this  argument
              only  permits  synthetic  events  to  be enabled; whether or not
              synthetic  events  are   delivered   is   controlled   via   the
              SyntheticEvents resource variable.

TERMINOLOGY

       Throughout this manual, the following terms are used:

       Screen:
              This  refers  to  a  specific monitor; essentially, there is one
              screen for every monitor run by your workstation.  Each  monitor
              has a view into a particular desktop.  In X terminology, this is
              the screen component of a particular display.

       Desktop:
              This refers to the entire area in which windows can reside on  a
              given  screen.   In non-virtual window managers, a desktop and a
              screen are the same size.  In a virtual window manager,  though,
              a desktop is larger than the screen.

       VDM    or  Virtual  Desktop  Manager  is  the  window  which represents
              visually the entire desktop:  it provides a scaled-down  version
              of the entire desktop.

       Logical Screen:
              If  the  desktop  is  running in default mode, it will display a
              grid, each square of which maps to  the  size  of  the  monitor.
              Each square is termed a logical screen.

       Current View:
              is  that part of the desktop which is currently displayed on the
              screen; this will usually (but need not always) correspond to  a
              logical screen.

       Virtual Window:
              is  a  small rectangle displayed in the VDM; every window on the
              desktop has a corresponding Virtual Window in the VDM.

VIRTUAL DESKTOP MANAGER

       When it is started, olvwm displays a virtual  desktop  manager  window.
       The  VDM  is  a reduced display of all windows active on the desktop at
       any time.  The current view is outlined in the virtual desktop manager.
       The VDM always appears on the screen.

       By  default,  the  VDM  (and hence the desktop) is divided into a grid;
       each square of the grid represents a screen size.  The  dividing  lines
       between each logical screen are represented by dashed lines in the VDM.
       This division into logical screens is  purely  informational:   if  you
       like,  windows can straddle these boundaries, the current view into the
       desktop can straddle these boundaries, and window can be moved at  will
       between these boundaries.  However, by default, most actions in the VDM
       will keep the current view along these boundary lines.

EVENTS IN THE VDM

       The processing of events within the VDM depends on whether the mouse is
       pointing  to  the background area of the VDM or to a particular virtual
       window within the VDM.

EVENTS ON VIRTUAL WINDOWS

       Events which occur in a particular virtual window  behave  just  as  if
       they  were  delivered  to the corresponding application's frame.  Thus,
       pressing the MENU button over a virtual window will bring up the  frame
       menu  and  allow  the  real (and virtual) windows to be opened, closed,
       resized, etc.  Pressing the SELECT button will select  that  real  (and
       virtual) window; pressing the ADJUST button will add (or subtract) that
       window from the selection list.  Pressing the FRONT or OPEN  keys  will
       raise/lower or open/close the real (and virtual) window.

       SELECTing  and  dragging one or more virtual windows will move the real
       and virtual windows (just as in olwm).  Note that if you drag the mouse
       outside  of  the  VDM,  the  window  can  be  moved onto to the screen.
       Conversely, when dragging a window on the screen, if  the  mouse  moves
       into  the  VDM,  the  window  will then be moved to the location on the
       displayed within the VDM.  However, if part of the VDM is obscured, you
       cannot move a window into that part of the VDM.

       Note  that  events  are delivered ONLY to the real application's frame.
       Thus, typing characters or the COPY/CUT/PASTE keys has no effect.

       It is possible to drop something onto a virtual window as  if  it  were
       dropped  onto  the  corresponding  application; this allows you to, for
       example, drag a file from the mailtool on the screen to a file  manager
       on another part of the desktop.

EVENTS ON THE VDM BACKGROUND

       Events  on  the  VDM  background  all  work to change the current view,
       bringing windows which were formerly outside of the current  view  onto
       the  screen (and moving windows which were on the screen outside of the
       current view).  Keyboard events are described  given  the  default  Sun
       Type-4  keyboard  mappings,  but  you  can  use  xmodmap to set up your
       particular keyboard.

       Keyboard Events:
              The arrow keys (and other keys) can be used to shift the current
              view  in the direction specified.  See the section on ADDITIONAL
              KEY BINDINGS below.  Keyboard events are  also  active  if  they
              occur on the root window in addition to the VDM background.

       SELECT mouse events: SELECTing on the VDM background allows you to drag
              the current view within the VDM.  If the VirtualGrid resource is
              set to Visible or Invisible, movement of the visible region will
              be constrained to logical  screen  boundaries  unless  the  CTRL
              button  is pressed before and held while dragging the mouse.  If
              the VirtualGrid resource is set to None, movement of the visible
              region  will  be unconstrained unless the CTRL button is pressed
              before and held while dragging the mouse.

       DOUBLE CLICK
              SELECT events: Double clicking the SELECT button on an  area  in
              the  VDM  background  will  move the current view to the logical
              screen containing the point where the mouse was double-clicked.

       MENU   mouse events: The MENU button brings up a (pinnable) menu  which
              will  allow movement based on full screen sizes in the direction
              indicated.

RESIZING THE VIRTUAL DESKTOP

       You can use the resize corners on the VDM to resize the virtual desktop
       at  will.  If you make the virtual desktop smaller, windows which might
       be off the new virtual desktop will NOT be moved (though they will  not
       be  lost,  either,  and  you  can get them back by resizing the desktop
       again). Space added or subtracted is always done so from the right  and
       bottom of the desktop (regardless of which resize corner you used).

STICKY WINDOWS

       You'll  notice  that  the  virtual  desktop manager never moves on your
       screen if you change views into the desktop.  That's because the VDM is
       permanently "sticky."

       Windows  which  are "sticky" never move position on the screen when you
       change your view into the desktop.   To  set  a  particular  window  as
       sticky,  simply  select  "Stick"  in  its frame menu. You may similarly
       unstick the window via its menu.

       [Note:  Only base frames--those which can be iconified, as  opposed  to
       those which have a pushpin--are eligible to become sticky; other frames
       inherit  the  stickyness  of  their  base  frames.   Thus,   for   most
       applications,  either  all windows are sticky or none of them are.  The
       exception to this is applications which create two or more base frames;
       all  base  frames will be originally created as "unsticky" (but see the
       VirtualSticky resource below).]

CHANGES TO THE WINDOW MENU

       The window menu of all windows has all the tools defined in  olwm.   In
       addition, the menu of base windows has the following command

       Stick/Unstick
              Affect  the  stickyness of the particular window.  Windows which
              are sticky will always appear in the same place on the screen no
              matter  which  part  of  the  virtual desktop you're looking at.
              Windows which are not sticky (by default, all windows except the
              VDM)  will  move when you change the current view on the virtual
              desktop.

CHANGES TO ROOT MENU

       The following additional keywords can be used in the command field of a
       root menu menu item:

       COLUMNS
              This  specifies  the  number  of  columns you'd like the menu to
              have.  Each column within a menu will be filled in order of  the
              items  in  the  menu.   The  menu  name  must appear before this
              keyword, and the keyword itself must appear before  the  end  of
              the menu.

       STICK_UNSTICK_SELN
              This  specifies  that  the  sticky state of the selected windows
              should be toggled.

       WINMENU
              brings up a pull-right menu containing the name of every  window
              on  the current monitor (if olvwm is managing multiple monitors,
              only windows on the current monitor  will  be  shown).   Windows
              which   are  iconified  are  preceded  with  a  graphic  symbol.
              Selecting one of these windows causes the view into the  desktop
              to  shift  so  that the selected window is visible; the selected
              window will be opened if iconic and raised to  the  top  of  the
              stacking  order.   This  behavior can be altered; see olvwmrc(5)
              for more details.  You may specify the number of columns in  the
              pull-right menu by using a number after the WINMENU keyword.  By
              default,  the  order  of  the  menu  is  alphabetic;   see   the
              SortMenuType resource below for more options.

       DIRMENU
              brings  up  a  pull-right menu containing the name of every file
              given in the named directory.  This allows you to  use  a  local
              programs  directory  for  a  tool repository; whenever tools are
              added to the directory, users will see  the  new  choices.   The
              directory   name   may  contain  environmental  variables  (e.g.
              $OPENWINHOME).  You may also specify a regular expression as the
              file  part  of  DIRMENU;  e.g. $OPENWINHOME/bin/x* would display
              only those programs in the openwindows bin directory which begin
              with  an  x.   Regular expressions do not apply to the directory
              name; $OPENWINHOME/b*/x* is an invalid DIRMENU entry.

       X11 Bitmaps and Pixmaps
              can be specified in the menu by specifying a  filename  enclosed
              in  <>  brackets.   The filename specified must be in X11 bitmap
              form, XPM2 form  (produced  by  IconEdit),  XPM3  form,  or  Gif
              format.   You  can  mix bitmap and string entries within a menu,
              though perhaps menus look better if you do not.

       MOVE_DESKTOP
              specifies that olvwm should move the view to either the  logical
              screen specified after the MOVE_DESKTOP entry (e.g. MOVE_DESKTOP
              3 moves to the third logical screen) or to  the  logical  screen
              containing  the  point  specified  after  the MOVE_DESKTOP entry
              (e.g. MOVE_DESKTOP 2304 0 also moves to the third logical screen
              in a default configuration).

       Here  is  a  version  of the example olwm root menu specification:  the
       programs menu will have  2  columns;  there  will  be  a  way  to  find
       particular  windows  off  the "Find" submenu (and that menu will have 3
       columns);  whatever  local  tools  are  available  can  be   found   in
       /usr/local; and the cmdtool option will be displayed as an icon:

       "My Custom Menu" TITLE

       Programs                 MENU
       Programs       COLUMNS 2
               </usr/openwin/include/X11/bitmaps/terminal>  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
            "Local Tools"       DIRMENU   /usr/local
       Programs                END PIN

       "Repaint Screen"        REFRESH

       "Properties ..."        PROPERTIES

       "Find"         WINMENU   3

       Exit            EXIT

MISCELLANEOUS NEW FEATURES

       This  section describes miscellaneous window manager features which are
       not directly related to the virtual nature of olvwm.

       Upon receiving a USR1 signal, olvwm will  execute  a  RESTART  function
       just like the restart function available from the root menu.

       The  root workspace will not be repainted on exit if the PaintWorkspace
       resource is False.

       The olwm resource DefaultIconImage will now accept either an X11 Bitmap
       file,  a  version  2  or 3 XPM image file or a GIF file.  If you use an
       image file, remember that the  DefaultIconMask  must  still  be  a  X11
       Bitmap; generally you will want to create a full mask in that case.

       The olwm resource WorkspaceBitmap will accept X11 Bitmap files, version
       2 or 3 XPM image files, or GIF files.  The  MaxMapColors  resource  can
       restrict the number of colors olvwm uses for each GIF file to help with
       colormap problems, but in general, specifying more than 1 GIF file will
       lead to colormap problems.

RESOURCES TO CONTROL THE VIRTUAL DESKTOP

       See the man page for olwm for a complete description of resources.  All
       resources of class OpenWindows and olwm described there  are  supported
       by  olvwm.   In addition, for olvwm only, resources of instance "olvwm"
       are  also  read.   You  can  thus  name  the  following  resources   as
       olvwm.<resource>,   olwm.<resource>,   or   as   OpenWindows.<resource>
       depending on your naming preference.

       Resources marked with an *  may  be  specified  on  a  screen-by-screen
       basis;    e.g.   olvwm.screen0.resource   and   olvwm.screen1.resource,
       following the pattern in olwm.

       VirtualDesktop (string)*
              Specifies the size of the virtual desktop.  You can specify this
              in terms of screen sizes, so that a virtual desktop of 3 screens
              across and 2 screens high would appear as the string  3x2.   You
              may  also  specify  this  in terms of absolute pixel sizes, e.g.
              3800x1800, as long as the pixel size is greater than the size of
              your framebuffer.  Default value: 3x2

       PannerScale (int)*
              Sets  the  scale  in  which  the virtual desktop manager will be
              drawn.  Default value: 15.

       VirtualGeometry (string)*
              Specifies the geometry string of the desktop manager in standard
              X11  format  (wxh+x+y).  The width and height, if specified, are
              ignored, but the x and y can be  used  to  specify  the  initial
              location of the desktop manager.  Default value: +0+0

       VirtualIconGeometry (string)*
              Specifies  the  geometry  string  of the desktop manager icon in
              standard  X11  format  (wxh+x+y).   The  width  and  height  are
              ignored,  but  the  x  and  y can be used to specify the initial
              location of the desktop manager icon.  Default value: +0+0

       VirtualIconic (Boolean)*
              If true, the virtual desk manager will come up iconic.   Default
              value:  False

       AllowMoveIntoDesktop (Boolean)
              If true, allows windows to be moved from the screen into the VDM
              and vice versa.  Otherwise, moving a window on the  screen  will
              only  allow  it to be placed in the visible screen; and moving a
              window in the desktop manager will not let it  be  dragged  onto
              the screen.  Default value:  True

       AllowArrowInRoot (Boolean)
              If  true, then key events in the root window will affect the VDM
              and thus move the view into the desktop (if the appropriate  key
              is  pressed).   Otherwise,  only key events when the VDM has the
              input event focus will have an effect.  Default value:  True

       VirtualFont (string)*
              The font name used  to  display  title  of  windows  within  the
              virtual desktop manager.  Default value:  5x8

       VirtualFontColor (color specification)*
              The color of the title within the virtual windows of the virtual
              desktop manager.  Default value:  Black

       VirtualBackgroundColor (color specification)*
              The color of the background  of  the  virtual  desktop  manager.
              Default value:  Based on the frame color of your desktop.

       VirtualForegroundColor (color specification)*
              The color of the virtual windows in the virtual desktop manager.
              Default value:  The frame color of your desktop.

       VirtualBackgroundMap (Pixmap filename)*
              The name of a file containing a pixmap to use as the  background
              of  the  virtual  desktop  manager.  This will be drawn with the
              VirtualBackgroundColor  as  its   background   color   and   the
              VirtualPixmapColor  as  its  foreground  color.  The file can be
              either an X bitmap file, a Z Pixmap file, or a Gif file.   Color
              reduction  can  be carried out on these images by specifying the
              MaxMapColors resource.  If the file is NOT  a  bitmap  file  the
              virtual  desktop window title is changed to be the filename part
              of the file and the Maximum Size  window  hint  is  set  to  the
              dimensions of the pixmap.  Default value:  unused

       MaxMapColors (number of colors)*
              This  integer  value specifies the maximum number of colors that
              olvwm will try and allocate for  the  VirtualBackgroundMap.   If
              the actual number of colors in the pixmap is greater, the colors
              are remapped to this  number  using  a  'best  match'  algorithm
              (Heckbert Median Cut).  Default value: 200

       VirtualPixmapColor (color specification)*
              See above; this value only applies when the VirtualBackgroundMap
              has depth 1.  Default value:  white

       VirtualSticky (list of strings)
              The list of windows which should be sticky by default.  Like the
              olwm  MinimalDecor, this should be the list windows which should
              be sticky when they are created.  The matching of these  strings
              is done by the first word of the window's WM_NAME (string in its
              title  bar),  or  by  its  WM_CLASS  class/instance   variables.
              Default value:  Null

       RelativePosition (Boolean)
              If  true, then user-specified window co-ordinates are assumed to
              be relative to the current view into the desktop; otherwise they
              are  absolute with respect to the desktop.  Setting to true will
              not allow you to bring up  windows  outside  your  current  view
              (unless you specify very large or negative numbers), and setting
              to false will break some programs which save window states in an
              odd  manner.   You  can  defeat  this  variable  on  startup  of
              applications by specifying which screen they  should  start  on;
              see olvwmrc(5).  Default value: True

       VirtualGrid (Visible, Invisible, or None)*
              This  controls  two  aspects  of  the  VDM:   If it's visible or
              invisible, the grid is on (but it's only drawn if it's visible).
              If  it's  None, the grid is off.  If the grid is on, the VDM may
              only be resized in logical screen-sized increments.   Otherwise,
              it  may  resized  to  arbitrary  sizes.   If  the  grid  is  on,
              SELECT/dragging the mouse within the VDM will constrain the move
              to logical screens (unless the CTRL button is held down); if the
              grid is off, moving the visible screen region  with  SELECT/drag
              will  be  unconstrained  (unless  the CTRL button is held down).
              Default value:    Visible

       VirtualGridColor (color specification)
              If the VirtualGrid is Visible, it will be drawn in  this  color.
              Default value:  Same as VirtualFontColor

       VirtualRaiseVDM (Boolean)
              If  this  is  true,  the  VDM  will  always appear on top of the
              stacking order, never to be obscured by other windows.   Default
              value:  False

       VirtualMoveGroup (Boolean)
              If  true, then whenever a window is moved to a different logical
              screen, then all followers of that window will also be  moved  a
              similar  amount:  this affects the window's icon and popups.  In
              this way, icons and  popups  will  always  appear  on  the  same
              logical  screen  as  their corresponding base frame.  Otherwise,
              only the selected windows will move  when  you  move  them,  and
              related  windows  could  possibly  appear  on  different logical
              screens in  the  desktop.   The  trigger  for  changing  between
              logical  screens  is  the window's mid-point; all windows in the
              group will appear on the same logical screen as the mid-point of
              the moved window.  Default value: True

       UseImages (UseNone, UseVDM, or UseAll)
              If  set  to  UseNone, then window frame menus and the VDM motion
              menu will be text-based.  If set to  UseVDM,  the  window  frame
              menus  will  be  text-based,  but  the VDM motion menu will be a
              graphic menu.  If set to UseAll, the window frame menus will  be
              text-  and  image-based,  and the VDM motion menu will be image-
              based.  Default value: UseVDM

       SortMenuType (Enum)
              This option  controls  how  windows  appearing  in  the  WINMENU
              command  are  sorted.   If it is set to Alphabetic, then windows
              will be  sorted  alphabetically  by  name.   If  it  is  set  to
              Youngest,  then  windows will be sorted from youngest to oldest.
              Default value:  Alphabetic

       VirtualDrawSticky (True)
              If this option is set, sticky windows will  have  their  virtual
              windows  drawn  in the VDM just like any other window.  If it is
              false, then sticky windows will not have their  virtual  windows
              drawn in the VDM.  Default value:  True

       StickyIcons (Boolean)
              When  set,  StickyIcons  will  cause  all  non-sticky windows to
              become sticky when iconified.  This makes all icons  visible  on
              every  screen.   All  windows  made  sticky  when iconified will
              become unsticky when reopened.  Default value:  False

       StickyIconScreen (Boolean)
              StickyIconScreen, when used  in  conjunction  with  StickyIcons,
              will  cause  all  iconified  windows  that  are  made  sticky to
              remember the screen on which they  were  closed.   When  one  of
              these  windows  is  reopened the user will be warped back to the
              screen from which the window was closed and the window  is  made
              unsticky.  Default value:  False

       FreeIconSlots (Boolean)
              By  default,  when an icon is created, it has that icon position
              forever (unless it is moved manually), even when the  window  is
              not  iconified.   This  results in potentially large gaps in the
              icon area when lots of little programs  are  run  (clocks,  load
              averages,  etc)  which are rarely iconified.  When this resource
              is true and a window is opened, if the icon  position  what  not
              set  manually the slots are freed.  The effect is that iconified
              windows pack together in the corner specified by  IconPlacement.
              If  you  move  an  icon  manually,  it  maintains that position.
              Default value: False

       UniqueIconSlots (Boolean)
              This  resource,  when  set  to   true,   prevents   icons   from
              overlapping.   If  you  move  an  icon  into  icon  grid slot(s)
              occupied by other icons, those icons move.  If those other icons
              were  positioned manually, they are no longer viewed as manually
              placed  (unless,  of  course,  they  are  subsequently  manually
              placed) Default value:  False

       IconGridHeight (Integer)
              IconGridWidth (Integer) Previously the size of the icon grid was
              fixed.  An icon takes up a number of grid  slots,  depending  on
              it's  size,  and  is  aligned  with the lower left corner of its
              lower left grid slot.  Changing the size of the grid changes how
              icons arrange themselves.  Default value:  13 for each

ADDITIONAL MISCELLANEOUS RESOURCES

       These  resources  are  not  related  specifically  to  the VDM, but are
       included as new features within olvwm.

       InputFocusColor (color specification)*
              Specifying this attribute means that the  frame  of  the  window
              which currently has the input focus should be drawn in the color
              specified instead of in the normal frame color.  The  appearance
              of  the  title bar (with lines or indentation, depending on your
              input focus mode) will remain unchanged.  Default  value:   None
              (Use standard frame color)

       RaiseOnMove (Boolean)
              If  this  is  True,  then whenever a window is moved, it is also
              raised to the top of the stacking order.  Default value:  False

       AutoShowRootMenu (Boolean)
              If true, the root menu will come up pinned at start up.  Default
              value:  False

       AutoRootMenuX (int)
              If  AutoShowRootMenu  is  true, this is the X location where the
              menu will come up.  Default value: 0

       AutoRootMenuY (int)
              If AutoShowRootMenu is true, this is the Y  location  where  the
              menu will come up.  Default value: 0

       FullSizeZoomX (Boolean)
              If this is set to True, then selecting Full Size from the window
              menu will zoom the window horizontally as  well  as  vertically.
              Default value:  False

       NoDecor (list of strings)
              Like  Minimal  Decor,  this attribute takes a list of windows on
              which to operate; these windows should not be decorated at  all.
              There  is a slight difference between this attribute and setting
              the override_redirect flag on a window:  the latter causes olvwm
              to  ignore  completely the window, while this attribute does not
              adorn the window or give it a menu, but still allows  it  to  be
              manipulated  via  the  WINMENU and Hot Key actions.  Normal olwm
              keys are ignored by these windows, however.

       ResizeMoveGeometry (X geometry string or the word center)
              This resource only has  an  effect  if  ShowMoveGeometry  and/or
              ShowResizeGeometry  is  set  to True.  This string specifies the
              location of the geometry box when it is displayed; it should  be
              given  as  an X geometry string (wxh+x+y) although the width and
              height are ignored if specified.  If you  want  the  box  to  be
              centered  regardless  of your monitor resolution, use the string
              center instead of a geometry string.  Default value: +0+0

       PaintWorkspace (Boolean)
              If true, olvwm will paint the root workspace with the  color  of
              the  WorkspaceColor  resource.   If False, olvwm will not change
              root workspace.  Default value:  True

       PointerWorkspace (Boolean)
              If true, olvwm will change the cursor when  it  is  over  window
              frames  and other olvwm-owned windows.  If False, olvwm will not
              change the cursor.  This is useful in conjunction with  xsetroot
              -cursor  if  you  want  the  specified  cursor to be active over
              frames.  Default value:  True

       SaveWorkspaceCmd (String)
              If  set,  this  is  the  command  that  will  be  run  when  the
              SAVE_WORKSPACE   command   is   selected   off  the  main  menu.
              Otherwise, the default command is run.  Default value:  owplaces
              -silent -multi -script -tw -output $HOME/.openwin-init

       SyntheticEvents (boolean)
              This  resource  controls the delivery of synthetic events.  This
              resource is only valid if the -allowSynthetic argument was given
              to  olvwm  on  startup;  if  that  argument was present and this
              resource is set to  True,  then  olvwm  will  process  synthetic
              events.   Otherwise,  synthetic  events  are  ignored.   Default
              value:  False

       ParentScreenPopup (Boolean)
              If true the popups are placed on the same screen as their parent
              even  if  the  parent is not currently visible. Otherwise popups
              always appear on the current screen.  A suggested method  is  to
              place  the  following  lines  at  the  end of your .xinitrc file
              (before the final wait command):
              xrdb -merge <<'EOF'
              olvwm.ParentScreenPopup: False
              EOF
              In this way, your session will initialize with all  popups  with
              their  parents but subsequenct popups will appear on the current
              screen.  Default value:        True

CURSOR RESOURCES

       These set of resources change the default cursors  the  window  manager
       gives  certain  classes  it  creates,  such  as  resize  buttons, close
       buttons, frames, icons, etc.   The  <cursor  string>  is  described  as
       follows:

              <cursor font name> <cursor index> [<fore color> [<back color>]]

       where  options  enclosed  in []'s are optional.  If the <back color> is
       left out, the default back color (which, in this version of  OLVWM,  is
       white)  is  used.   If  the  <fore color> is left out, then the default
       cursor (foreground) color is used, which is black  by  default,  unless
       set  by  the cursorColor resource (see below).  Note that to supply the
       <back color>, you must supply the <fore color>.   Also,  if  the  color
       name  you  provide is invalid, OLVWM will return to the default colors,
       as described above.   As  per  usual  with  resources,  no  errors  are
       reported.   The  cursor font is assumed to be encoded so that the valid
       mask for the cursor follows the cursor index in the font; this  is  the
       usual behavior for font files.

       There is an alternate form of <cursor string>:

              <cursor name> [<fore color> [<back color>]]

       where  <cursor  name>  is either the name of the X cursor as defined in
       cursorfont.h (eg: XC_X_cursor, XC_cross, etc.), or the name of an  OPEN
       LOOK cursor as defined in olcursor.h (e.g.: OLC_basic, OLC_busy).

       The valid <cursor>s are:

       CursorBasic
              Specify  the  root window cursor.  Default: Basic Pointer (arrow
              pointing NW)

       CursorMove
              Specify the cursor when  a  window  is  moved.   Default:  Basic
              Pointer

       CursorBusy
              Specify  the  cursor for when a window is "busy".  Default: Busy
              Pointer (pocket watch)

       CursorIcon
              Specify cursor for the icon windows.  Default: Basic Pointer

       CursorResize
              Specify cursor for the resize buttons and when window  is  being
              "rubber-band" resized.  Default: Bull's Eye

       CursorMenu
              Specify cursor for menu windows.  Default: Basic Pointer

       CursorTarget
              Specify cursor for window frames.  Default: Basic Pointer

       CursorCloseUp
              Specify cursor for close button, when NOT pressed (the button is
              UP).  Default: Basic Pointer

       CursorCloseDown
              Specify cursor for close button, when  pressed  (the  button  is
              DOWN).  Default: Basic Pointer

       CursorSpecialResize  <Bool>  [<fg  corner>  <bg  corner>  <fg move> <bg
       move>]
              This is a special Cursor resource  which  turns  on  specialized
              resize  cursors.   If  <Bool>  is false, then the cursor for the
              resize button decorations and the "rubber-band" window  are  all
              specified  by  "Cursor.Resize" as discussed above.  If <Bool> is
              true, then the following modifications are turned on:  When  the
              cursor  is  within the resize button decorations on a frame, the
              cursor becomes a corner of the  appropriate  orientation.   When
              the  button  is  selected  and the window is being "rubber-band"
              resized, the cursor  becomes  the  appropriate  corner  with  an
              appropriately  oriented  arrow.  The colors that you can specify
              are limited to prevent an obscene number of resources.  You  can
              specify  the  colors  (foreground and background) of the cursors
              when placed in the resize decoration without  the  mouse  button
              down  (described  above as <fg corner> and <bg corner>), and you
              can specify the colors of the cursors when the mouse  button  is
              down  the  window is being resized (described above as <fg move>
              and <bg move>).  Note that you  must  specify  either  all  four
              colors or no colors.

ADDITIONAL KEY BINDINGS

       Like  olwm,  olvwm  uses key bindings for certain actions:  all actions
       specified in olwm as well as an additional set of  actions  to  control
       the view into the desktop.  In the following list, the key mentioned in
       parentheses is the default binding for the given action;  items  marked
       with  a  plus sign '+' are items which exist in olwm; they are included
       here to describe what action they have when  they  occur  on  the  root
       window  or  within  the VDM.  All other bindings are specific to olvwm;
       those items marked   with  an  asterisk  '*'  involve  keyboard  grabs.
       Bindings  which  involve  a  keyboard grab (those with an asterisk) are
       always active, no matter where the input focus is; otherwise the action
       occurs only if the root window or the VDM has the input focus.

       It's  possible  to change each of these bindings, see the olwm man page
       for more details.

       GrabVirtualKeys " (Boolean)"
              This  resource  controls  whether  the  keys  below  marked   as
              involving  grabs will be active or not.  If this resource is set
              to False, then  none  of  the  bindings  marked  below  with  an
              asterisk will ever be active.  Default value:  True

       Up  (up-arrow) +
              Move the view up one screen.

       JumpUp (up-arrow+Ctrl) +
              Move the view up ten screens.

       HalfUp (up-arrow+Shift)
              Move the view up one-half screen.

       VirtualUp  (up-arrow+Meta) *
              Move the view up one screen.

       VirtualJumpUp (up-arrow+Ctrl+Meta) *
              Move the view up ten screens.

       VirtualHalfUp (up-arrow+Shift+Meta) *
              Move the view up one-half screen.

       Down (down-arrow) +
              Move the view down one screen.

       JumpDown (down-arrow+Ctrl) +
              Move the view down ten screens.

       HalfDown (down-arrow+Shift)
              Move the view down one-half screen.

       VirtualDown  (down-arrow+Meta) *
              Move the view down one screen.

       VirtualJumpDown (down-arrow+Ctrl+Meta) *
              Move the view down ten screens.

       VirtualHalfDown (down-arrow+Shift+Meta) *
              Move the view down one-half screen.

       Left (left-arrow) +
              Move the view left one screen.

       JumpLeft (left-arrow+Ctrl) +
              Move the view left ten screens.

       HalfLeft (left-arrow+Shift)
              Move the view left one-half screen.

       VirtualLeft  (left-arrow+Meta) *
              Move the view left one screen.

       VirtualJumpLeft (left-arrow+Ctrl+Meta) *
              Move the view left ten screens.

       VirtualHalfLeft (left-arrow+Shift+Meta) *
              Move the view left one-half screen.

       Right (right-arrow) +
              Move the view right one screen.

       JumpRight (right-arrow+Ctrl) +
              Move the view right ten screens.

       HalfRight (right-arrow+Shift)
              Move the view right one-half screen.

       VirtualRight  (right-arrow+Meta) *
              Move the view right one screen.

       VirtualJumpRight (right-arrow+Ctrl+Meta) *
              Move the view right ten screens.

       VirtualHalfRight (right-arrow+Shift+Meta) *
              Move the view right one-half screen.

       GoHome (R11)
              Move the view to the upper left corner.

       VirtualHome (R11+Meta) *
              Move the view to the upper left corner.

       UpLeft (Home, R7) +
              Move the view NorthWest one screen.

       JumpUpLeft (R7+Ctrl) +
              Move the view NorthWest ten screens.

       HalfUpLeft (R7+Shift)
              Move the view NorthWest one-half screen.

       VirtualUpLeft (R7+Meta) *
              Move the view NorthWest one screen.

       VirtualJumpUpLeft (R7+Ctrl+Meta) *
              Move the view NorthWest ten screens.

       VirtualHalfUpLeft (R7+Shift+Meta) *
              Move the view NorthWest one-half screen.

       DownLeft (End, R13) +
              Move the view SouthWest one screen.

       JumpDownLeft (R13+Ctrl) +
              Move the view SouthWest ten screens.

       HalfDownLeft (R13+Shift)
              Move the view SouthWest one-half screen.

       VirtualDownLeft (R13+Meta) *
              Move the view SouthWest one screen.

       VirtualJumpDownLeft (R13+Ctrl+Meta) *
              Move the view SouthWest ten screens.

       VirtualHalfDownLeft (R13+Shift+Meta) *
              Move the view SouthWest one-half screen.

       UpRight (R9)
              Move the view NorthEast one screen.

       JumpUpRight (R9+Ctrl)
              Move the view NorthEast ten screens.

       HalfUpRight (R9+Shift)
              Move the view NorthEast one-half screen.

       VirtualUpRight (R9+Meta) *
              Move the view NorthEast one screen.

       VirtualJumpUpRight (R9+Ctrl+Meta) *
              Move the view NorthEast ten screens.

       VirtualHalfUpRight (R9+Shift+Meta) *
              Move the view NorthEast one-half screen.

       DownRight (R15, PgDn)
              Move the view SouthEast one screen.

       JumpDownRight (R15+Ctrl)
              Move the view SouthEast ten screens.

       HalfDownRight (R15+Shift)
              Move the view SouthEast one-half screen.

       VirtualDownRight (R15+Meta) *
              Move the view SouthEast one screen.

       VirtualJumpDownRight (R15+Ctrl+Meta) *
              Move the view SouthEast ten screens.

       VirtualHalfDownRight (R15+Shift+Meta) *
              Move the view SouthEast one-half screen.

       Screen1   (F1)
              Move to the first logical screen in the desktop.

       VirtualScreen1 (F1+Meta) *
              Move to the first logical screen in the desktop.

       Screen2   (F2)
              Move to the second logical screen in the desktop.

       VirtualScreen2 (F2+Meta) *
              Move to the second logical screen in the desktop.

       Screen3   (F3)
              Move to the third logical screen in the desktop.

       VirtualScreen3 (F3+Meta) *
              Move to the third logical screen in the desktop.

       Screen4   (F4)
              Move to the fourth logical screen in the desktop.

       VirtualScreen4 (F4+Meta) *
              Move to the fourth logical screen in the desktop.

       Screen5   (F5)
              Move to the fifth logical screen in the desktop.

       VirtualScreen5 (F5+Meta) *
              Move to the fifth logical screen in the desktop.

       Screen6   (F6)
              Move to the sixth logical screen in the desktop.

       VirtualScreen6 (F6+Meta) *
              Move to the sixth logical screen in the desktop.

       Screen7   (F7)
              Move to the seventh logical screen in the desktop.

       VirtualScreen7 (F7+Meta) *
              Move to the seventh logical screen in the desktop.

       Screen8   (F8)
              Move to the eighth logical screen in the desktop.

       VirtualScreen8 (F8+Meta) *
              Move to the eighth logical screen in the desktop.

       Screen9   (F9)
              Move to the ninth logical screen in the desktop.

       VirtualScreen9 (F9+Meta) *
              Move to the ninth logical screen in the desktop.

       Screen10 (F10)
              Move to the tenth logical screen in the desktop.

       VirtualScreen10     (F10+Meta) *
              Move to the tenth logical screen in the desktop.

       SaveWorkspace (F10+Meta+Alt+Shift) *
              Execute a Save Workspace command

       ToggleDragWindows (F6+Alt+Shift) *
              Toggles the setting of the DragWindow resource

       ToggleMoveGroups (g+Alt) *
              Toggles the setting of the VirtualMoveGroup resource

       ToggleSizeFullZoomX (F3+Alt+Shift) *
              Toggles the setting of the FullSizeZoomX resource

       ToggleSticky (s+Alt) *
              Toggles the sticky state of the window with input focus.

ADVANCED USAGE

       olvwm   will   read   a  resource  file  ($HOME/.olvwmrc)  for  special
       customizations.  These customizations allow the following:

       HOT KEYS
              You can specify that when a certain key (or, more likely, key in
              combination  with modifiers) is pressed that certain actions are
              performed:  you can warp  to  a  particular  application,  open,
              raise,  or  close  applications,  execute applications, and quit
              applications.

       SCREEN BINDINGS
              You can specify that certain applications will always start on a
              particular logical screen.

       MENU OPTIONS
              You   can  alter  the  behaviour  of  WINMENU  selections  on  a
              particular window.

       Please see olvwmrc(5) for details of these options.

COPYRIGHTS

       The X Window system is a trademark of the  Massachusetts  Institute  of
       Technology.
       OPEN LOOK is a trademark of AT&T.
       OpenWindows is a trademark of Sun Microsystems, Inc.
       Portions  (c)  Copyright  1989-1991  Sun  Microsystems, Inc. Sun design
       patents pending in the U.S. and  foreign  countries.  OPEN  LOOK  is  a
       trademark of AT&T. Used by written permission of the owners.
       Portions  (c)  Copyright  Bigelow  &  Holmes  1986,  1985.  Lucida is a
       registered trademark of Bigelow & Holmes. Permission to use the  Lucida
       trademark  is  hereby  granted  only in association with the images and
       fonts described in this file.
       Portions may be (c) 1990 Solbourne Computers.
       Portions not covered under the above  copyrights  are  (c)  1991  Scott
       Oaks.
       Please  see  the  LEGAL_NOTICES  file  for full disclosure of copyright
       information.

CREDITS

       Most of the code in this application comes from release  3.0  of  olwm,
       authored  at Sun Microsystems and distributed in the contrib section of
       MIT's X11R5.  [Note that nothing in xview3 or release 3.0 requires  R5;
       they  will happily run on R4 and exist in R5 simply because that's when
       they were released.]
       The virtual  desktop  section  was  authored  by  Scott  Oaks,  who  is
       responsible  for  its  maintenance.   Please  direct  any  comments  to
       scott.oaks@sun.com.  This code is not supported by Sun Microsystems  in
       any way.
       Notwithstanding   the   above,  the  staff  at  Sun  Microsystems,  and
       especially Stuart Marks, deserve credit as original author of olwm  for
       most of the work contained in this application.
       Innumerable  people  have made fixes and enhancements to olvwm, and I'm
       very bad at listing them all (but drop me a note and I'll do better  in
       a  future  release  :-)).   Thus,  the  following  list  is by no means
       comprehensive, but these people have all provided something  to  olvwm:
       Tor  Arntsen,  Paul Andrews, Rich Berlin, David Boyd, David Chase, John
       Durand, Alexander Dupuy, Paul Eggert, Eric Fifer, Duane  Gibson,  Jimmy
       Guggemos,   Orest   Jarosiewicz,   Russel  Kegley,  Murray  Laing,  Tom
       McConnell, Blair MacIntyre, Chuck Musciano, Matthias  Pfuetzner,  David
       Plotkin,  Harry  Protoolis,  Nir  Samburski,  Andreas  Stolcke, Hinrich
       Tobaben, Larry Virden, Ken West, and Ron Winacott.

                               30 November 1992                       OLVWM(1)