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