the on-line manual should use the same notation for key bindings

as the configuration file, this way writing configuration files is easier;
add a few missing interactive command (.Ic) macros to key bindings;
slightly improve spacing in the lists; other tweaks.

ok martynas@
This commit is contained in:
sobrado 2009-06-18 20:24:54 +00:00
parent 1183bd535d
commit b0a20e655b

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: cwm.1,v 1.39 2009/02/07 16:59:11 martynas Exp $ .\" $OpenBSD: cwm.1,v 1.40 2009/06/18 20:24:54 sobrado Exp $
.\" .\"
.\" Copyright (c) 2004,2005 Marius Aamodt Eriksen <marius@monkey.org> .\" Copyright (c) 2004,2005 Marius Aamodt Eriksen <marius@monkey.org>
.\" .\"
@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\" .\"
.Dd $Mdocdate: February 7 2009 $ .Dd $Mdocdate: June 18 2009 $
.Dt CWM 1 .Dt CWM 1
.Os .Os
.Sh NAME .Sh NAME
@ -51,14 +51,14 @@ Right mouse button
.Pp .Pp
.Nm .Nm
is very simple in its use. is very simple in its use.
Most of the actions are initiated via keybindings. Most of the actions are initiated via key bindings.
The current keybindings are described below; The current key bindings are described below;
their functionality is described in more detail later. their functionality is described in more detail later.
.Pp .Pp
.Bl -tag -width "C-M-EscapeXXX" -offset indent -compact .Bl -tag -width "CM-EscapeXXXXX" -offset indent -compact
.It Ic C-M-Return .It Ic CM-Return
Spawn a new terminal. Spawn a new terminal.
.It Ic C-M-Delete .It Ic CM-Delete
Lock the screen. Lock the screen.
.It Ic M-Return .It Ic M-Return
Hide current window. Hide current window.
@ -70,27 +70,27 @@ Raise current window.
Search for windows. Search for windows.
.It Ic C-/ .It Ic C-/
Search for applications. Search for applications.
.It Ic C-M-n .It Ic CM-n
Label current window. Label current window.
.It Ic M-Tab .It Ic M-Tab
Cycle through currently visible windows. Cycle through currently visible windows.
.It Ic M-S-Tab .It Ic MS-Tab
Reverse cycle through currently visible windows. Reverse cycle through currently visible windows.
.It Ic C-M-x .It Ic CM-x
Delete current window. Delete current window.
.It Ic C-M-[n] .It Ic CM-[n]
Select group n, where n is 1-9. Select group n, where n is 1-9.
.It Ic C-M-0 .It Ic CM-0
Select all groups. Select all groups.
.It Ic C-M-g .It Ic CM-g
Toggle group membership of current window. Toggle group membership of current window.
.It Ic M-Right .It Ic M-Right
Cycle through active groups. Cycle through active groups.
.It Ic M-Left .It Ic M-Left
Reverse cycle through active groups. Reverse cycle through active groups.
.It Ic C-M-f .It Ic CM-f
Toggle full-screen size of current window. Toggle full-screen size of current window.
.It Ic C-M-= .It Ic CM-=
Toggle vertical maximization of current window. Toggle vertical maximization of current window.
.It Ic M-? .It Ic M-?
Spawn Spawn
@ -105,15 +105,15 @@ This parses
to provide host auto-completion. to provide host auto-completion.
.Xr ssh 1 .Xr ssh 1
will be executed via the configured terminal emulator. will be executed via the configured terminal emulator.
.It Ic C-M-w .It Ic CM-w
Spawn Spawn
.Dq Exec WindowManager .Dq Exec WindowManager
dialog; allows you to switch from dialog; allows you to switch from
.Nm .Nm
to another window manager without restarting the X server. to another window manager without restarting the X server.
.It Ic C-M-S-r .It Ic CMS-r
Reload configuration. Reload configuration.
.It Ic C-M-S-q .It Ic CMS-q
Quit Quit
.Nm . .Nm .
.El .El
@ -121,15 +121,15 @@ Quit
The mouse bindings are also important, they are: The mouse bindings are also important, they are:
.Pp .Pp
.Bl -tag -width Ds -offset indent -compact .Bl -tag -width Ds -offset indent -compact
.It M-M1 .It Ic M-M1
Move current window. Move current window.
.It C-M-M1 .It Ic CM-M1
Toggle group membership of current window. Toggle group membership of current window.
.It M-M2 .It Ic M-M2
Resize current window Resize current window
.It M-M3 .It Ic M-M3
Lower current window. Lower current window.
.It CMS-M3 .It Ic CMS-M3
Hide current window. Hide current window.
.El .El
.Pp .Pp
@ -145,22 +145,34 @@ Specify the display to use.
.El .El
.Sh POINTER MOVEMENT .Sh POINTER MOVEMENT
The pointer can be moved with the use of the keyboard through bindings. The pointer can be moved with the use of the keyboard through bindings.
C-[UP|DOWN|LEFT|RIGHT] moves the pointer a small amount, while .Ic C-[Up|Down|Left|Right]
C-shift-[UP|DOWN|LEFT|RIGHT] moves the pointer a larger amount. moves the pointer a small amount, while
.Ic CS-[Up|Down|Left|Right]
moves the pointer a larger amount.
For example, to move the pointer to the left by a small amount, For example, to move the pointer to the left by a small amount,
press C-LEFT. press
To move the pointer down by a larger amount, press C-shift-DOWN. .Ic C-Left .
To move the pointer down by a larger amount, press
.Ic CS-Down .
.Sh WINDOW MOVEMENT AND RESIZING .Sh WINDOW MOVEMENT AND RESIZING
.Nm .Nm
windows can be moved with the use of the keyboard through Vi-like bindings. windows can be moved with the use of the keyboard through
M-[hjkl] moves the current window a small amount, while M-shift-[hjkl] moves .Cm vi Ns -like
the current window a larger amount. bindings.
For example, to move the current window to the left a small amount, press M-h. .Ic M-[hjkl]
To move the current window down by a larger amount, press M-shift-j. moves the current window a small amount, while
.Ic MS-[hjkl]
moves the current window a larger amount.
For example, to move the current window to the left a small amount, press
.Ic M-h .
To move the current window down by a larger amount, press
.Ic MS-j .
.Pp .Pp
Similarly, windows may be resized with the same keybindings with the addition Similarly, windows may be resized with the same key bindings with the addition
of the Control key. of the Control key.
C-M-[hjkl] resizes the window a small amount and C-M-shift-[hjkl] .Ic CM-[hjkl]
resizes the window a small amount and
.Ic CMS-[hjkl]
resizes by a larger increment. resizes by a larger increment.
.Sh SEARCH .Sh SEARCH
.Nm .Nm
@ -181,7 +193,7 @@ The window is the currently focused window.
The window is hidden. The window is hidden.
.El .El
.Pp .Pp
The following keybindings may be used to navigate the result list: The following key bindings may be used to navigate the result list:
.Pp .Pp
.Bl -tag -width "[Down] or C-s or M-j" -offset indent -compact .Bl -tag -width "[Down] or C-s or M-j" -offset indent -compact
.It Ic [Down], C-s No or Ic M-j .It Ic [Down], C-s No or Ic M-j
@ -217,13 +229,13 @@ and a red border will be shown on those just removed.
Menus are recalled by clicking the mouse on the root window: Menus are recalled by clicking the mouse on the root window:
.Pp .Pp
.Bl -tag -width 10n -offset -indent -compact .Bl -tag -width 10n -offset -indent -compact
.It M1 .It Ic M1
Show list of currently hidden windows. Show list of currently hidden windows.
Clicking on an item will unhide that window. Clicking on an item will unhide that window.
.It M2 .It Ic M2
Show list of currently defined groups. Show list of currently defined groups.
Clicking on an item will hide/unhide that group. Clicking on an item will hide/unhide that group.
.It M3 .It Ic M3
Show list of applications as defined in Show list of applications as defined in
.Pa ~/.cwmrc . .Pa ~/.cwmrc .
Clicking on an item will spawn that application. Clicking on an item will spawn that application.