diff options
Diffstat (limited to '')
| -rw-r--r-- | cwm.1 | 223 |
1 files changed, 223 insertions, 0 deletions
@@ -0,0 +1,223 @@ +.\" $OpenBSD: cwm.1,v 1.1.1.1 2007/04/27 17:58:48 bernd Exp $ +.\" +.\" 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 |