Man Linux: Main Page and Category List

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: Bulls 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