JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
Make time localized too.
[spectrwm.git] / scrotwm.1
index 79b9118..fe77be1 100644 (file)
--- a/scrotwm.1
+++ b/scrotwm.1
@@ -13,7 +13,7 @@
 .\" 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
@@ -123,8 +123,10 @@ For example, 0.6 is 60% of the physical screen size.
 .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 and Spanish keyboards are
-provided in scrotwm_us.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
@@ -144,7 +146,7 @@ See
 .Pa master_add ,
 .Pa master_del ,
 .Pa stack_inc ,
-.Pa stack_del ,
+.Pa stack_dec ,
 and
 .Pa always_raise
 for more information.
@@ -189,7 +191,8 @@ Enable by setting to 1.
 .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 .
@@ -359,7 +362,7 @@ master_del
 .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
@@ -385,9 +388,9 @@ wind_del
 .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
@@ -469,7 +472,7 @@ Add windows to master area.
 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.
@@ -578,6 +581,24 @@ bind[] = Mod1+q # unbind Alt + q
 .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
@@ -691,9 +712,11 @@ Quirks specified in the configuration file override the automatic quirks.
 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
@@ -702,7 +725,8 @@ For the
 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
@@ -713,7 +737,8 @@ $ xprop \-id $WINDOWID WM_NAME | grep \-o "\\".*\\""
 .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):
@@ -722,7 +747,8 @@ $ wmctrl \-i \-a 0x4a0000b
 .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):
@@ -733,7 +759,8 @@ $ wmctrl \-i \-c 0x4a0000b
 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
@@ -743,7 +770,8 @@ $ wmctrl \-i \-r 0x4a0000b \-b toggle,_NET_WM_STATE_ABOVE
 .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