OLVWM(1) User Commands OLVWM(1)

NAME

olvwm - OPEN LOOK virtual window manager for X11 and OpenWindows

SYNOPSIS

olvwm [ options ]

DESCRIPTION

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

OPTIONS

There is one new option to olvwm.

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

TERMINOLOGY

Throughout this manual, the following terms are used:

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

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

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

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

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

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

VIRTUAL DESKTOP MANAGER

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

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

EVENTS IN THE VDM

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

EVENTS ON VIRTUAL WINDOWS

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

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

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

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

EVENTS ON THE VDM BACKGROUND

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

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

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

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

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

RESIZING THE VIRTUAL DESKTOP

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

STICKY WINDOWS

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

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

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

CHANGES TO THE WINDOW MENU

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

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

CHANGES TO ROOT MENU

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

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

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

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

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

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

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

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


"My Custom Menu" TITLE

Programs MENU
Programs COLUMNS 2
</usr/openwin/include/X11/bitmaps/terminal> DEFAULT cmdtool
"Text Editor" textedit
Mail mailtool
"File Manager" filemgr
Other MENU
"Other Tools" TITLE
"Shell Tool" shelltool
"Icon Editor" iconedit
Clock clock
"Perf Meter" DEFAULT perfmeter
Other END
"Local Tools" DIRMENU /usr/local
Programs END PIN

"Repaint Screen" REFRESH

"Properties ..." PROPERTIES

"Find" WINMENU 3

Exit EXIT

MISCELLANEOUS NEW FEATURES

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

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

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

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

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

RESOURCES TO CONTROL THE VIRTUAL DESKTOP

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ADDITIONAL MISCELLANEOUS RESOURCES

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

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

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

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

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

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

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

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

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

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

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

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

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

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

CURSOR RESOURCES

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

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

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

There is an alternate form of <cursor string>:

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

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

The valid <cursor>s are:

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

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

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

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

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

CursorMenu
Specify cursor for menu windows. Default: Basic Pointer

CursorTarget
Specify cursor for window frames. Default: Basic Pointer

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

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

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

ADDITIONAL KEY BINDINGS

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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


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

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

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

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

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

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


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

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

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

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

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

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


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

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


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

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

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

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

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

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


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

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

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

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

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

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


UpRight (R9)
Move the view NorthEast one screen.

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

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

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

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

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


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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ADVANCED USAGE

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

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

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

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

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

COPYRIGHTS

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

CREDITS

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

30 November 1992 OLVWM(1)