X-Git-Url: https://code.delx.au/spectrwm/blobdiff_plain/087a4593471d57d75c330e3dde5ec7c902bc50f3..5aee442940fa67ccb0cdeeb805d987c3a4b0d7c4:/spectrwm.1 diff --git a/spectrwm.1 b/spectrwm.1 index f719acd..71c53de 100644 --- a/spectrwm.1 +++ b/spectrwm.1 @@ -1,6 +1,6 @@ .\" Copyright (c) 2009-2012 Marco Peereboom .\" Copyright (c) 2009 Darrin Chandler -.\" Copyright (c) 2011-2014 Reginald Kennedy +.\" Copyright (c) 2011-2015 Reginald Kennedy .\" Copyright (c) 2011-2012 Lawrence Teo .\" Copyright (c) 2011-2012 Tiago Cunha .\" Copyright (c) 2012 David Hill @@ -99,6 +99,27 @@ Defined in the format e.g. ws[2]:xterm launches an .Xr xterm 1 in workspace 2. +.Pp +Note that workspace mapping is handled via +.Pa libswmhack.so . +When +.Ic autorun +spawns windows via a daemon, ensure the daemon is started +with the correct +.Pa LD_PRELOAD +in its environment. +.Pp +For example, starting +.Xr urxvtd 1 +via +.Xr xinit 1 : +.Bd -literal -offset indent +LD_PRELOAD=/usr/lib/libswmhack.so.0.0 urxvtd -q -o -f +.Ed +.Pp +Spawned programs automatically have +.Pa LD_PRELOAD +set when executed. .It Ic bar_action External script that populates additional information in the status bar, such as battery life. @@ -294,6 +315,11 @@ and changes to layout. .It Ar manual Set window focus on window interaction only. .El +.It Ic maximize_hide_bar +When set to 1, +.Ic maximize_toggle +will also hide/restore the bar visibility of the affected workspace. +Defaults to 0. .It Ic java_workaround Workaround a Java GUI rendering issue on non-reparenting window managers by impersonating the LG3D window manager, written by Sun. @@ -329,6 +355,7 @@ See .Ic master_del , .Ic stack_inc , .Ic stack_dec , +.Ic stack_balance , and .Ic always_raise for more information. @@ -418,8 +445,9 @@ Set this to the opposite of to collapse the border between tiles. Disable by setting to 0. .It Ic urgent_collapse -Enables hiding of placeholders in the urgency hint indicator for workspaces that -do not have any urgent windows. +Minimizes the space consumed by the urgency hint indicator by removing the +placeholders for non-urgent workspaces, the trailing space when there are +urgent windows and the default leading space. Enable by setting to 1. .It Ic urgent_enabled Enable or disable the urgency hint indicator in the status bar. @@ -443,6 +471,15 @@ See and .Ar stack_dec for more information. +.It Ic workspace_clamp +Prevents workspaces from being swapped when attempting to switch to a workspace +that is mapped to another region. +Use +.Ar warp_focus +if you want to focus on the region containing the workspace and +.Ar warp_pointer +if you want to also send the pointer. +Enable by setting to 1. .It Ic window_class_enabled Enable or disable displaying the window class name (from WM_CLASS) in the status bar. @@ -461,6 +498,13 @@ the bar, it's limited to 64 characters, by default. See the .Ic bar_format option for more details. +.It Ic warp_focus +Focus on the target window/workspace/region when clamped. +For example, when attempting to switch to a workspace that is mapped on another +region and +.Ar workspace_clamp +is enabled, focus on the region with the target workspace. +Enable by setting to 1. .It Ic warp_pointer Centers the mouse pointer on the focused window when using key bindings to change focus, switch workspaces, change regions, etc. @@ -589,6 +633,8 @@ cycle_layout flip_layout .It Cm M-S- Ns Aq Cm Space stack_reset +.It Cm Aq Ar unbound +stack_balance .It Cm M-h master_shrink .It Cm M-l @@ -646,15 +692,19 @@ ws_next_all .It Cm M- Ns Aq Cm Down ws_prev_all .It Cm M-a -ws_next_move +ws_prior .It Cm M-S- Ns Aq Cm Left ws_prev_move .It Cm M-S- Ns Aq Cm Up -ws_prior +ws_next_move .It Cm M-S- Ns Aq Cm Right rg_next .It Cm M-S- Ns Aq Cm Left rg_prev +.It Cm Aq Ar unbound +rg_move_next +.It Cm Aq Ar unbound +rg_move_prev .It Cm M-s screenshot_all .It Cm M-S-s @@ -726,6 +776,8 @@ Cycle layout. Swap the master and stacking areas. .It Cm stack_reset Reset layout. +.It Cm stack_balance +Balance master/stacking area. .It Cm master_shrink Shrink master area. .It Cm master_grow @@ -805,6 +857,10 @@ Switch to last visited workspace. Switch to next region. .It Cm rg_prev Switch to previous region. +.It Cm rg_move_next +Switch region to next screen. +.It Cm rg_move_prev +Switch region to previous screen. .It Cm screenshot_all Take screenshot of entire screen (if enabled) (see @@ -974,30 +1030,10 @@ XTERM_FONTADJ The quirks themselves are described below: .Pp .Bl -tag -width "XTERM_FONTADJXXX" -offset indent -compact -.It FLOAT -This window should not be tiled, but allowed to float freely. -.It TRANSSZ -Adjusts size on transient windows that are too small using -.Ic dialog_ratio -(see -.Sx CONFIGURATION FILES ) . .It ANYWHERE Allow window to position itself, uncentered. -.It XTERM_FONTADJ -Adjust -.Xr xterm 1 -fonts when resizing. -.It FULLSCREEN -Remove border to allow window to use full region size. -.It FOCUSPREV -On exit force focus on previously focused application not previous -application in the stack. -.It NOFOCUSONMAP -Don't change focus to the window when it first appears on the screen. -Has no effect when -.Ic focus_mode -is set to -.Ar follow . +.It FLOAT +This window should not be tiled, but allowed to float freely. .It FOCUSONMAP_SINGLE When the window first appears on the screen, change focus to the window if there are no other windows on the workspace with the same WM_CLASS @@ -1006,20 +1042,45 @@ Has no effect when .Ic focus_mode is set to .Ar 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 FOCUSPREV +On exit force focus on previously focused application not previous +application in the stack. +.It FULLSCREEN +Remove border to allow window to use full region size. .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. +.It MINIMALBORDER +Remove border when window is unfocused and floating. +.It NOFOCUSCYCLE +Remove from normal focus cycle (focus_prev or focus_next). The window can +still be focused using search_win. +.It NOFOCUSONMAP +Don't change focus to the window when it first appears on the screen. +Has no effect when +.Ic focus_mode +is set to +.Ar 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 TRANSSZ +Adjusts size on transient windows that are too small using +.Ic dialog_ratio +(see +.Sx CONFIGURATION FILES ) . .It WS Ns Bq Ar n Force a new window to appear on workspace .Ar n . +.It XTERM_FONTADJ +Adjust +.Xr xterm 1 +fonts when resizing. .El .Pp Custom quirks in the configuration file are specified as follows: