X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=spectrwm.1;h=2654dc0fbfb666715dfa5677a08567ea3e3cb028;hb=9fc72f5c49ab3fdb79776b244ddd45f24132c266;hp=b85f44f23b70a5494983a9db07ba77de9a4bb914;hpb=e83f3b790887174fe8b8fd6b3c98172b59ff9305;p=spectrwm.git diff --git a/spectrwm.1 b/spectrwm.1 index b85f44f..2654dc0 100644 --- a/spectrwm.1 +++ b/spectrwm.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: February 8 2012 $ +.Dd $Mdocdate: February 15 2012 $ .Dt SPECTRWM 1 .Os .Sh NAME @@ -103,6 +103,34 @@ Status bar font. .It Ic bar_font_color Ns Bq Ar x Color of the font in status bar in screen .Ar x . +.It Ic bar_format +Set the bar_format string and overrides +.Ic clock_format +and all of the +.Ic enabled +options. +The format is passed through +.Xr strftime 3 +before being used. +It may contain the following character sequences: +.Bl -column "Character sequence" "Replaced with" -offset indent +.It Sy "Character sequence" Ta Sy "Replaced with" +.It Li "+A" Ta "Output of the external script" +.It Li "+C" Ta "Window class" +.It Li "+D" Ta "Workspace name" +.It Li "+I" Ta "Workspace index" +.It Li "+N" Ta "Screen number" +.It Li "+S" Ta "Stacking algorithm" +.It Li "+T" Ta "Window title" +.It Li "+U" Ta "Urgency hint" +.It Li "+V" Ta "Program version" +.It Li "+W" Ta "Window name" +.It Li "++" Ta "A literal" Ql + +.El +.Pp +All character sequences may limit its output to a specific length, for example ++64A. +Any characters that don't match the specification are copied as-is. .It Ic bar_justify Justify the status bar text. Possible values are .Pa left , @@ -134,6 +162,29 @@ This ratio is the screen size to what they will be resized. For example, 0.6 is 60% of the physical screen size. .It Ic disable_border Remove border when bar is disabled and there is only one window on the screen. +.It Ic focus_close +Window to put focus when the focused window is closed. +Possible values are +.Pa first , +.Pa next , +.Pa previous +(default) and +.Pa last . +.Pa next +and +.Pa previous +are relative to the window that is closed. +.It Ic focus_close_wrap +Whether to allow the focus to jump to the last window when the first window is +closed or vice versa. +Disable by setting to 0. +.It Ic focus_default +Window to put focus when no window has been focused. +Possible values are +.Pa first +and +.Pa last +(default). .It Ic focus_mode Using a value of .Pa follow_cursor @@ -201,6 +252,19 @@ e.g.\& screen[1]:800x1200+0+0. To make a screen span multiple monitors, create a region big enough to cover them all, e.g. screen[1]:2048x768+0+0 makes the screen span two monitors with 1024x768 resolution sitting one next to the other. +.It Ic spawn_position +Position in stack to place newly spawned windows. +Possible values are +.Pa first , +.Pa next , +.Pa previous +and +.Pa last +(default). +.Pa next +and +.Pa previous +are relative to the focused window. .It Ic stack_enabled Enable or disable displaying the current stacking algorithm in the status bar. .It Ic term_width @@ -241,6 +305,8 @@ Enable by setting to 1. .It Ic window_name_enabled Enable or disable displaying the window name in the status bar. Enable by setting to 1. +.It Ic workspace_limit +Set the total number of workspaces available. Minimum is 1, maximum is 22. .El .Pp Colors need to be specified per the @@ -343,7 +409,7 @@ Resize window while maintaining it centered .Pp The default key bindings are described below: .Pp -.Bl -tag -width "M-j, M-XXX" -offset indent -compact +.Bl -tag -width "M-j, M-XXXXXX" -offset indent -compact .It Cm M-S- Ns Aq Cm Return term .It Cm M-p @@ -394,10 +460,10 @@ bar_toggle wind_del .It Cm M-S-x wind_kill -.It Cm M- Ns Aq Ar n -.Pf ws_ Ar n -.It Cm M-S- Ns Aq Ar n -.Pf mvws_ Ar n +.It Cm M- Ns Aq Ar 1-9,0,F1-F12 +.Pf ws_ Aq Ar 1-22 +.It Cm M-S- Ns Aq Ar 1-9,0,F1-F12 +.Pf mvws_ Ns Aq Ar 1-22 .It Cm M- Ns Aq Cm Right ws_next .It Cm M- Ns Aq Cm Left @@ -516,13 +582,13 @@ Switch to workspace .Ar n , where .Ar n -is 1 through 10. +is 1 through workspace_limit. .It Cm mvws_ Ns Ar n Move current window to workspace .Ar n , where .Ar n -is 1 through 10. +is 1 through workspace_limit. .It Cm ws_next Switch to next workspace with a window in it. .It Cm ws_prev @@ -614,6 +680,24 @@ To use the currently defined 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 +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 å: +.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) "å" + XFilterEvent returns: False +.Ed +.Pp +The xkb name is aring. In other words, in .spectrwm.conf add: +.Bd -literal -offset indent +bind[program] = MOD+aring +.Ed .Sh KEYBOARD MAPPING FILES Keyboard mapping files for several keyboard layouts are listed below. @@ -851,4 +935,6 @@ was written by: .It Cm Tuukka Kataja Aq stuge@xor.fi .It Cm Jason L. Wright Aq jason@thought.net .It Cm Reginald Kennedy Aq rk@rejii.com +.It Cm Lawrence Teo Aq lteo@lteo.net +.It Cm Tiago Cunha Aq tcunha@gmx.com .El