.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: October 27 2011 $
+.Dd $Mdocdate: November 11 2011 $
.Dt SCROTWM 1
.Os
.Sh NAME
.It Cm keyboard_mapping
Clear all key bindings and load new key bindings from the specified file.
This allows you to load pre-defined key bindings for your keyboard layout.
-At present, keyboard mapping files for the US, French and Spanish keyboards are
-provided in scrotwm_us.conf, scrotwm_fr.conf and scrotwm_es.conf respectively.
+See the
+.Sx KEYBOARD MAPPING FILES
+section below for a list of keyboard mapping files that have been provided
+for several keyboard layouts.
.It Cm layout
Select layout to use at start-of-day.
Defined in the format
.Pa master_add ,
.Pa master_del ,
.Pa stack_inc ,
-.Pa stack_del ,
+.Pa stack_dec ,
and
.Pa always_raise
for more information.
.It Cm urgent_enabled
Enable or disable the urgency hint.
Note that many terminal emulators require this to be enabled for it to
-propagate. In xterm, for example, one needs to add the following line
+propagate.
+In xterm, for example, one needs to add the following line
.Pa xterm.urgentOnBell: true
to
.Pa .Xdefaults .
.It Cm M-S-,
stack_inc
.It Cm M-S-.
-stack_del
+stack_dec
.It Cm M- Ns Aq Cm Return
swap_main
.It Xo
.It Cm M-S-x
wind_kill
.It Cm M- Ns Aq Ar n
-ws_ Ns Ar n
+.Pf ws_ Ar n
.It Cm M-S- Ns Aq Ar n
-mvws_ Ns Ar n
+.Pf mvws_ Ar n
.It Cm M- Ns Aq Cm Right
ws_next
.It Cm M- Ns Aq Cm Left
Remove windows from master area.
.It Cm stack_inc
Add columns/rows to stacking area.
-.It Cm stack_del
+.It Cm stack_dec
Remove columns/rows from stacking area.
.It Cm swap_main
Move current window to master area.
.Ed
.Pp
Multiple key combinations may be bound to the same action.
+.Sh KEYBOARD MAPPING FILES
+Keyboard mapping files for several keyboard layouts are listed
+below.
+These files can be used with the
+.Pa keyboard_mapping
+setting to load pre-defined key bindings for the specified
+keyboard layout.
+.Pp
+.Bl -tag -width "scrotwm_XX.confXXX" -offset indent -compact
+.It Cm scrotwm_cz.conf
+Czech Republic keyboard layout
+.It Cm scrotwm_es.conf
+Spanish keyboard layout
+.It Cm scrotwm_fr.conf
+French keyboard layout
+.It Cm scrotwm_us.conf
+United States keyboard layout
+.El
.Sh QUIRKS
.Nm
provides "quirks" which handle windows that must be treated specially
partially implements the Extended Window Manager Hints (EWMH) specification.
This enables controlling windows as well as
.Nm
-itself from external scripts and programs. This is achieved by
+itself from external scripts and programs.
+This is achieved by
.Nm
-responding to certain ClientMessage events. From the terminal these events
+responding to certain ClientMessage events.
+From the terminal these events
can be conveniently sent using tools such as
.Xr wmctrl 1
and
actual format of these ClientMessage events, see the EWMH specification.
.Pp
The id of the currently focused window is stored in the _NET_ACTIVE_WINDOW
-property of the root window. This can be used for example to retrieve the
+property of the root window.
+This can be used for example to retrieve the
title of the currently active window with
.Xr xprop 1
and
.Ed
.Pp
A window can be focused by sending a _NET_ACTIVE_WINDOW client message
-to the root window. For example, using
+to the root window.
+For example, using
.Xr wmctrl 1
to send the message
(assuming 0x4a0000b is the id of the window to be focused):
.Ed
.Pp
Windows can be closed by sending a _NET_CLOSE_WINDOW client message
-to the root window. For example, using
+to the root window.
+For example, using
.Xr wmctrl 1
to send the message
(assuming 0x4a0000b is the id of the window to be closed):
Windows can be floated and un-floated by adding or removing the
_NET_WM_STATE_ABOVE atom from the _NET_WM_STATE property of the window.
This can be achieved by sending a _NET_WM_STATE client message to the
-root window. For example, the following toggles the floating state of
+root window.
+For example, the following toggles the floating state of
a window using
.Xr wmctrl 1
to send the message (assuming 0x4a0000b is the id of the window floated
.Ed
.Pp
Floating windows can also be resized and moved by sending a
-_NET_MOVERESIZE_WINDOW client message to the root window. For example,
+_NET_MOVERESIZE_WINDOW client message to the root window.
+For example,
using
.Xr wmctrl 1
to send the message (assuming 0x4a0000b is the id of