X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=scrotwm.1;h=617668cbe1c98a2fd4d2930345f549bf1974f5c6;hb=350001b0254a537a720d0a37f5b01385122ebed6;hp=811b18e2e469ce92d5879c07fec2bc3b156635e7;hpb=d5d74890e7cc1f89bb7a1b1c4c43fb146e7a93a8;p=spectrwm.git

diff --git a/scrotwm.1 b/scrotwm.1
index 811b18e..617668c 100644
--- 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: December 6 2011 $
 .Dt SCROTWM 1
 .Os
 .Sh NAME
@@ -108,6 +108,12 @@ such as battery life.
 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
@@ -123,8 +129,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, 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
@@ -144,7 +152,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 +197,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 .
@@ -308,12 +317,12 @@ fields and will be substituted for values at the time the program is spawned:
 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
@@ -347,7 +356,7 @@ restart
 .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
@@ -359,7 +368,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,13 +394,17 @@ 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
 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
@@ -434,11 +447,17 @@ move_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
@@ -457,7 +476,7 @@ Restart
 .Nm .
 .It Cm cycle_layout
 Cycle layout.
-.It Cm reset_layout
+.It Cm stack_reset
 Reset layout.
 .It Cm master_shrink
 Shrink master area.
@@ -469,7 +488,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.
@@ -505,6 +524,10 @@ is 1 through 10.
 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
@@ -559,6 +582,12 @@ Move a floating window a step to the right.
 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:
@@ -578,6 +607,28 @@ 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_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
 .Sh QUIRKS
 .Nm
 provides "quirks" which handle windows that must be treated specially
@@ -691,9 +742,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 +755,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 +767,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 +777,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 +789,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 +800,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
@@ -784,7 +842,3 @@ was written by:
 .It Cm Tuukka Kataja Aq stuge@xor.fi
 .It Cm Jason L. Wright Aq jason@thought.net
 .El
-.Sh BUGS
-Currently the menu, invoked with
-.Cm M-p ,
-depends on dmenu.