CWM(1)                     OpenBSD Reference Manual                     CWM(1)

NAME
     cwm - a lightweight, efficient and aesthetic window manager for X11

SYNOPSIS
     cwm [-s]

DESCRIPTION
     cwm is a window manager for X11.  It was originally inspired by evilwm,
     but was rewritten from scratch due to limitations in the evilwm codebase.
     The from-scratch rewrite borrowed some code from 9wm.  cwm contains many
     new features which all concentrate on the efficiency of window manage-
     ment.


BASIC OPERATION
     We will adopt the following notation:

            C           Control
            M           Meta (Alt on PCs)
            M1          Left mouse button
            M2          Middle mouse button
            M3          Right mouse button

     cwm is very simple in its use.  Most of the actions are initiated via
     keybindings.  The current keybindings are described below, their func-
     tionality is described in more detail later.

            C-M-Enter   Spawn a new xterm.
            M-Enter     Hide current window.
            M-Down      Lower current window.
            M-Up        Raise current window.
            M-/         Search for windows.
            C-M-l       Label current window.
            M-Tab       Cycle through currently visible windows.
            C-M-x       Delete current window.
            C-M-Escape  Enter group edit mode.
            C-M-[n]     Select group n, where n is 1-9.
            C-M-0       Select all groups.
            C-M-Right   Switch to next group.
            C-M-Left    Switch to previous group.

     The mouse bindings are also important, they are:

            M-M1        Move a window.
            M-M2        Resize a window/Select a window.
            M-M3        Lower a window.

     The options for cwm are as follows:

     -s      Set sticky group mode on.


SEARCH
     cwm features the ability to search for windows by their current title,
     old titles and by their label.  The priority for the search results are:
     Label, current title, old titles in reverse order.  cwm keeps a history
     of the 5 previous titles of a window.

GROUPS
     cwm has the ability to group windows together, and use the groups to per-
     form operations on the entire group instead of just one window.  Current-
     ly, the only operation that is supported is to hide and unhide the
     grouped windows.  Together with the -s option, this can be used to emu-
     late virtual desktops.

     To edit groups, enter the group edit mode, and select/unselect the groups
     with the group selection mouse click.  A blue border will be shown on the
     currently selected windows.  The group selection keyboard shortcuts can
     also be used to change which group to edit.


MENUS
     Menus are recalled by clicking the mouse on the root window:

            M1          Show list of currently hidden windows.  Clicking on an
                        item will unhide that window.
            M2          Show list of currently defined groups.  Clicking on an
                        item will hide/unhide that group.
            M3          Show list of applications as defined in ~/.calmwm.
                        Clicking on an item will spawn that application.


ACKNOWLEDGEMENTS
     cwm contains some code from 9wm.


AUTHORS
     The cwm software has been developed by Marius Aamodt Eriksen
     <marius@monkey.org> with contributions from Andy Adamson
     <dros@monkey.org> and Niels Provos <provos@monkey.org>

OpenBSD 3.5                      July 10, 2004                               2