.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 11 2011 $
+.Dd $Mdocdate: November 30 2011 $
.Dt SCROTWM 1
.Os
.Sh NAME
Update frequency, in seconds, of external script that populates the status bar.
.It Cm bar_at_bottom
Place the statusbar at the bottom of each region instead of the top.
+.It Cm bar_justify
+Justify the status bar text. Possible values are
+.Pa left ,
+.Pa center ,
+and
+.Pa right .
.It Cm stack_enabled
Enable or disable displaying the current stacking algorithm in the status bar.
.It Cm clock_enabled
.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 .
Example:
.Bd -literal -offset indent
program[ff] = /usr/local/bin/firefox http://scrotwm.org/
-bind[ff] = Mod+f # Now Mod+F launched firefox
+bind[ff] = Mod+Shift+b # Now Mod+Shift+B launches firefox
.Ed
.Pp
To undo the previous:
.Bd -literal -offset indent
-bind[] = Mod+f
+bind[] = Mod+Shift+b
program[ff] =
.Ed
.Sh BINDINGS
.It Cm M- Ns Aq Cm Space
cycle_layout
.It Cm M-S- Ns Aq Cm Space
-reset_layout
+stack_reset
.It Cm M-h
master_shrink
.It Cm M-l
ws_next
.It Cm M- Ns Aq Cm Left
ws_prev
+.It Cm M- Ns Aq Cm Up
+ws_next_all
+.It Cm M- Ns Aq Cm Down
+ws_prev_all
.It Cm M-a
ws_prior
.It Cm M-S- Ns Aq Cm Right
move_up
.It Cm M-S-]
move_down
+.It Cm M-S-/
+name_workspace
+.It Cm M-/
+search_workspace
+.It Cm M-s
+search_win
.El
.Pp
The action names and descriptions are listed below:
.Pp
-.Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
+.Bl -tag -width "M-j, M-<TAB>XXXX" -offset indent -compact
.It Cm term
Spawn a new terminal
(see
.Nm .
.It Cm cycle_layout
Cycle layout.
-.It Cm reset_layout
+.It Cm stack_reset
Reset layout.
.It Cm master_shrink
Shrink master area.
Switch to next workspace with a window in it.
.It Cm ws_prev
Switch to previous workspace with a window in it.
+.It Cm ws_next_all
+Switch to next workspace.
+.It Cm ws_prev_all
+Switch to previous workspace.
.It Cm ws_prior
Switch to last visited workspace.
.It Cm screen_next
Move a floating window a step upwards.
.It Cm move_down
Move a floating window a step downwards.
+.It Cm name_workspace
+Name the current workspace.
+.It Cm search_workspace
+Search for a workspace.
+.It Cm search_win
+Search the windows in the current workspace.
.El
.Pp
Custom bindings in the configuration file are specified as follows:
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
+below.
+These files can be used with the
.Pa keyboard_mapping
setting to load pre-defined key bindings for the specified
keyboard layout.
Spanish keyboard layout
.It Cm scrotwm_fr.conf
French keyboard layout
+.It Cm scrotwm_fr_ch.conf
+Swiss French keyboard layout
+.It Cm scrotwm_se.conf
+Swedish keyboard layout
.It Cm scrotwm_us.conf
United States keyboard layout
.El
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