xenial (1) olvwm.1.gz

Provided by: olvwm_4.4.3.2p1.4-28.1_amd64 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).]

       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.

       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)