Add new option: warp_pointer.

[spectrwm.git] / spectrwm.1

diff --git a/spectrwm.1 b/spectrwm.1
index 1e48b78..9114861 100644 (file)
--- a/spectrwm.1
+++ b/spectrwm.1
@@ -287,7 +287,7 @@ section below for a list of keyboard mapping files that have been provided
 for several keyboard layouts.
 .It Ic layout
 Select layout to use at start-of-day. Defined in the format
-ws[idx]:master_grow:master_add:stack_inc:layout:always_raise:stack_mode, e.g.
+ws[idx]:master_grow:master_add:stack_inc:always_raise:stack_mode, e.g.
 ws[2]:-4:0:1:0:horizontal sets worskspace 2 to the horizontal stack mode and
 shrinks the master area by 4 ticks and adds one window to the stack, while
 maintaining default floating window behavior.
@@ -423,6 +423,10 @@ the bar, it's limited to 64 characters, by default.
 See the
 .Ic bar_format
 option for more details.
+.It Ic warp_pointer
+Centers the mouse pointer on the focused window when using key bindings to
+change focus, switch workspaces, change regions, etc.  Enable by setting to 1.
+Default is 0 (disabled.)
 .It Ic workspace_limit
 Set the total number of workspaces available. Minimum is 1, maximum is 22,
 default is 10.
@@ -626,6 +630,8 @@ initscr
 iconify
 .It Cm M-S-w
 uniconify
+.It Cm M-e
+maximize_toggle
 .It Cm M-S-r
 always_raise
 .It Cm M-v
@@ -836,16 +842,16 @@ specify MOD as the modifier key.
 .Pp
 Multiple key combinations may be bound to the same action.
 .Pp
-To bind non-latin characters such as å or π you must enter the xkb
+To bind non-latin characters such as \[oa] or \[*p] you must enter the xkb
 character name instead of the character itself. Run xev, focus the window
 and press the specific key and in the terminal output read the symbol name.
-In the fallowing example for å:
+In the following example for \[oa]:
 .Bd -literal -offset indent
 KeyPress event, serial 41, synthetic NO, window 0x2600001,
     root 0x15a, subw 0x0, time 106213808, (11,5), root:(359,823),
     state 0x0, keycode 24 (keysym 0xe5, aring), same_screen YES,
-    XLookupString gives 2 bytes: (c3 a5) "å"
-    XmbLookupString gives 2 bytes: (c3 a5) "å"
+    XLookupString gives 2 bytes: (c3 a5) "\[oa]"
+    XmbLookupString gives 2 bytes: (c3 a5) "\[oa]"
     XFilterEvent returns: False
 .Ed
 .Pp
@@ -946,6 +952,12 @@ When an application requests focus on the window via a _NET_ACTIVE_WINDOW
 client message (source indication of 1), comply with the request.
 Note that a source indication of 0 (unspecified) or 2 (pager) are always
 obeyed.
+.It IGNOREPID
+Ignore the PID when determining the initial workspace for a new window.
+Especially useful for terminal windows that share a process.
+.It IGNORESPAWNWS
+Ignore the spawn workspace when determining the initial workspace for a
+new window.
 .El
 .Pp
 Custom quirks in the configuration file are specified as follows: