X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=scrotwm.1;h=09b4f88e58576f0db9f77a5a057cea24d7a1e8bb;hb=63eea690871eadbb0998dd035cf8d2759f495016;hp=0cccc44a74675ff1c1557a83d37c809ec0965383;hpb=5b0a67a9cb6b64872dfdfc549632782989820174;p=spectrwm.git diff --git a/scrotwm.1 b/scrotwm.1 index 0cccc44..09b4f88 100644 --- a/scrotwm.1 +++ b/scrotwm.1 @@ -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 @@ -191,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 . @@ -394,6 +401,10 @@ wind_kill 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 @@ -436,11 +447,15 @@ move_right move_up .It Cm M-S-] move_down +.It Cm M-S-/ +name_workspace +.It Cm M-/ +search_workspace .El .Pp The action names and descriptions are listed below: .Pp -.Bl -tag -width "M-j, M-XXX" -offset indent -compact +.Bl -tag -width "M-j, M-XXXX" -offset indent -compact .It Cm term Spawn a new terminal (see @@ -507,6 +522,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 @@ -561,6 +580,10 @@ 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. .El .Pp Custom bindings in the configuration file are specified as follows: @@ -582,7 +605,8 @@ bind[] = Mod1+q # unbind Alt + q 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 +below. +These files can be used with the .Pa keyboard_mapping setting to load pre-defined key bindings for the specified keyboard layout. @@ -710,9 +734,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 @@ -721,7 +747,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 @@ -732,7 +759,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): @@ -741,7 +769,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): @@ -752,7 +781,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 @@ -762,7 +792,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