Initial revision
This commit is contained in:
bernd
223
cwm.1
Normal file
223
cwm.1
Normal file
@@ -0,0 +1,223 @@
|
||||
.\" $OpenBSD$
|
||||
.\"
|
||||
.\" The following requests are required for all man pages.
|
||||
.Dd July 10, 2004
|
||||
.Dt CWM 1
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm cwm
|
||||
.Nd a lightweight and efficient window manager for X11
|
||||
.Sh SYNOPSIS
|
||||
.\" For a program: program [-abc] file ...
|
||||
.Nm cwm
|
||||
.Op Fl s
|
||||
.Op Fl f Ar fontname
|
||||
.Sh DESCRIPTION
|
||||
.Nm
|
||||
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.
|
||||
.Nm
|
||||
contains many new features which all concentrate on the efficiency and
|
||||
transparency of window management.
|
||||
.Nm
|
||||
also aims to maintain the most simplest and pleasant aesthetic.
|
||||
|
||||
.Sh BASIC OPERATION
|
||||
We will adopt the following notation:
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It Fa C
|
||||
Control
|
||||
.It Fa M
|
||||
Meta (Alt on PCs)
|
||||
.It Fa S
|
||||
Shift
|
||||
.It Fa M1
|
||||
Left mouse button
|
||||
.It Fa M2
|
||||
Middle mouse button
|
||||
.It Fa M3
|
||||
Right mouse button
|
||||
.El
|
||||
|
||||
.Nm
|
||||
is very simple in its use. Most of the actions are initiated via
|
||||
keybindings. The current keybindings are described below, their
|
||||
functionality is described in more detail later.
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It Fa C-M-Enter
|
||||
Spawn a new terminal.
|
||||
.It Fa C-M-Delete
|
||||
Lock the screen.
|
||||
.It Fa M-Enter
|
||||
Hide current window.
|
||||
.It Fa M-Down
|
||||
Lower current window.
|
||||
.It Fa M-Up
|
||||
Raise current window.
|
||||
.It Fa M-/
|
||||
Search for windows.
|
||||
.It Fa C-/
|
||||
Search for applications.
|
||||
.It Fa C-M-l
|
||||
Label current window.
|
||||
.It Fa M-Tab
|
||||
Cycle through currently visible windows.
|
||||
.It Fa M-S-Tab
|
||||
Reverse cycle through currently visible windows.
|
||||
.It Fa C-M-x
|
||||
Delete current window.
|
||||
.It Fa C-M-Escape
|
||||
Enter group edit mode.
|
||||
.It Fa C-M-[n]
|
||||
Select group n, where n is 1-9.
|
||||
.It Fa C-M-0
|
||||
Select all groups.
|
||||
.It Fa M-Right
|
||||
Switch to next group.
|
||||
.It Fa M-Left
|
||||
Switch to previous group.
|
||||
.It Fa C-M-=
|
||||
Toggle vertical maximization of window.
|
||||
.El
|
||||
|
||||
The mouse bindings are also important, they are:
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It Fa M-M1
|
||||
Move a window.
|
||||
.It Fa C-M-M1
|
||||
Toggle a window's membership in the current group. A blue highlight
|
||||
indicates the window has been added to the group, a red highlight
|
||||
indicates it has been removed.
|
||||
.It Fa M-M2
|
||||
Resize a window/Select a window.
|
||||
.It Fa M-M3
|
||||
Lower a window.
|
||||
.El
|
||||
|
||||
The options for
|
||||
.Nm
|
||||
are as follows:
|
||||
.Bl -tag -width Ds
|
||||
.It Fl s
|
||||
Set sticky group mode on.
|
||||
The default behavior for new windows is to not assign any group.
|
||||
This changes the default behavior to assigning the currrently selected
|
||||
group to any newly created windows.
|
||||
.It Fl f Ar fontname
|
||||
Makes the
|
||||
.Xr Xft 3
|
||||
font string
|
||||
.Ar fontname
|
||||
the default font.
|
||||
.El
|
||||
|
||||
.Sh SEARCH
|
||||
.Nm
|
||||
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 and finally window
|
||||
class name.
|
||||
.Nm
|
||||
keeps a history of the 5 previous titles of a window.
|
||||
|
||||
When searching, the leftmost character of the result list may show a
|
||||
flag:
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It Fa !
|
||||
The window is the currently focused window.
|
||||
.It Fa &
|
||||
The window is hidden.
|
||||
.El
|
||||
|
||||
The following keybindings may be used to navigate the result list:
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It [Down] or C-s
|
||||
Select the next window in the list.
|
||||
.It [Up] or C-r
|
||||
Select the previous window in the list.
|
||||
.It C-u
|
||||
Clear the input.
|
||||
.It [Enter]
|
||||
Focus the selected window.
|
||||
.It [Esc]
|
||||
Quit.
|
||||
.It C-a
|
||||
Whenever there are no matching windows, list every window.
|
||||
.El
|
||||
|
||||
.Sh GROUPS
|
||||
.Nm
|
||||
has the ability to group windows together, and use the groups to
|
||||
perform operations on the entire group instead of just one window.
|
||||
Currently, the only operation that is supported is to hide and unhide
|
||||
the grouped windows. Together with the
|
||||
.Fl s
|
||||
option, this can be used to emulate 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.
|
||||
|
||||
.Sh MENUS
|
||||
Menus are recalled by clicking the mouse on the root window:
|
||||
|
||||
.Bl -tag -width 10n -offset -indent -compact
|
||||
.It Fa M1
|
||||
Show list of currently hidden windows. Clicking on an item will
|
||||
unhide that window.
|
||||
.It Fa M2
|
||||
Show list of currently defined groups. Clicking on an item will
|
||||
hide/unhide that group.
|
||||
.It Fa M3
|
||||
Show list of applications as defined in
|
||||
.Fa ~/.calmwm .
|
||||
Clicking on an item will spawn that application.
|
||||
.El
|
||||
|
||||
.Sh ~/.calmwm
|
||||
|
||||
Any directory entries here are shown in the application menu. When it
|
||||
is selected, the image is executed with
|
||||
.Xr execve 2 .
|
||||
One use of this is to create symbolic links for your favorite
|
||||
applications in this directory using
|
||||
.Xr ln 1 .
|
||||
|
||||
The entries
|
||||
.Nm term
|
||||
and
|
||||
.Nm lock
|
||||
have special meaning. When they exist they point to the terminal
|
||||
program and screen locking programs used by the keybindings specified
|
||||
above. The defaults for these are
|
||||
.Xr xterm 1
|
||||
and
|
||||
.Xr xlock 1 ,
|
||||
respectively.
|
||||
|
||||
.Sh ACKNOWLEDGEMENTS
|
||||
.Nm
|
||||
contains some code from 9wm.
|
||||
|
||||
.Sh AUTHORS
|
||||
The
|
||||
.Nm
|
||||
software has been developed by Marius Aamodt Eriksen
|
||||
.Aq marius@monkey.org
|
||||
with contributions from Andy Adamson
|
||||
.Aq dros@monkey.org ,
|
||||
Niels Provos
|
||||
.Aq provos@monkey.org
|
||||
and Antti Nykänen
|
||||
.Aq aon@iki.fi .
|
||||
Ideas, discussion with many others.
|
||||
.\" .Sh HISTORY
|
||||
.\".Aq marius@monkey.org .
|
||||
.\" .Sh CAVEATS
|
||||
Reference in New Issue
Block a user