]> code.delx.au - spectrwm/blobdiff - spectrwm.1
Convert all booleans to stdbool.h bool.
[spectrwm] / spectrwm.1
index 63a86cd55cb281429daa4684e5e7d669fae63a58..bc2ed7f8e4f9fd06d90fbf440df41e3162fcf943 100644 (file)
@@ -1,6 +1,6 @@
 .\" Copyright (c) 2009-2012 Marco Peereboom <marco@peereboom.us>
 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
-.\" Copyright (c) 2011-2013 Reginald Kennedy <rk@rejii.com>
+.\" Copyright (c) 2011-2014 Reginald Kennedy <rk@rejii.com>
 .\" Copyright (c) 2011-2012 Lawrence Teo <lteo@lteo.net>
 .\" Copyright (c) 2011-2012 Tiago Cunha <tcunha@gmx.com>
 .\" Copyright (c) 2012 David Hill <dhill@mindcry.org>
@@ -152,7 +152,6 @@ manpages.
 The
 .Xr xfontsel 1
 application can help with the XLFD setting.
-.Pp
 .It Ic bar_font_color Ns Bq Ar x
 Color of the font in status bar in screen
 .Ar x .
@@ -226,9 +225,15 @@ script.
 Display the number of iconic (minimized) windows in the status bar.
 Enable by setting to 1.
 .It Ic color_focus
-Border color of the currently focussed window.
+Border color of the currently focused window.  Default is red.
+.It Ic color_focus_maximized
+Border color of the currently focused, maximized window.  Defaults to the
+value of color_focus.
 .It Ic color_unfocus
-Border color of unfocussed windows.
+Border color of unfocused windows, default is rgb:88/88/88.
+.It Ic color_unfocus_maximized
+Border color of unfocused, maximized windows.  Defaults to the value of
+color_unfocus.
 .It Ic dialog_ratio
 Some applications have dialogue windows that are too small to be useful.
 This ratio is the screen size to what they will be resized.
@@ -270,6 +275,9 @@ and changes to layout.
 .It Cm manual
 Set window focus on window interaction only.
 .El
+.It Ic java_workaround
+Workaround a Java GUI rendering issue on non-reparenting window managers by
+impersonating LG3D window manager, written by Sun. Default is 1.
 .It Ic 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.
@@ -279,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.
@@ -310,6 +318,11 @@ This setting is not retained at restart.
 .It Ic modkey
 Change mod key.
 Mod1 is generally the ALT key and Mod4 is the windows key on a PC.
+.It Ic name
+Set the name of a workspace at start-of-day.
+Defined in the format ws[<idx>]:<name>, e.g. ws[1]:Console sets the name of
+workspace 1 to
+.Dq Console .
 .It Ic program Ns Bq Ar p
 Define new action to spawn a program
 .Ar p .
@@ -557,9 +570,9 @@ focus_next
 focus_prev
 .It Cm M-m
 focus_main
-.It Cm M-S-j
-focus_urgent
 .It Cm M-u
+focus_urgent
+.It Cm M-S-j
 swap_next
 .It Cm M-S-k
 swap_prev
@@ -613,6 +626,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
@@ -823,16 +838,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
@@ -928,6 +943,17 @@ if there are no other windows on the workspace with the same WM_CLASS
 class/instance value.  Has no effect when
 .Ic focus_mode
 is set to follow.
+.It OBEYAPPFOCUSREQ
+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: