.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 11 2011 $
+.Dd $Mdocdate: February 8 2012 $
.Dt SCROTWM 1
.Os
.Sh NAME
Enabling or disabling an option is done by using 1 or 0 respectively.
.Pp
The file supports the following keywords:
-.Pp
-.Bl -tag -width "title_class_enabledXXX" -offset indent -compact
-.It Cm autorun
+.Bl -tag -width 2m
+.It Ic autorun
Launch an application in a specified workspace at start-of-day.
Defined in the format ws[<idx>]:application, e.g. ws[2]:xterm launches an
xterm in workspace 2.
-.It Cm color_focus
-Border color of the currently focussed window.
-.It Cm color_unfocus
-Border color of unfocussed windows.
-.It Cm bar_enabled
-Enable or disable status bar.
-.It Cm bar_border Ns Bq Ar x
+.It Ic bar_action
+External script that populates additional information in the status bar,
+such as battery life.
+.It Ic bar_at_bottom
+Place the statusbar at the bottom of each region instead of the top.
+.It Ic bar_border Ns Bq Ar x
Color of the status bar border in screen
.Ar x .
-.It Cm bar_border_width
+.It Ic bar_border_width
Set status bar border thickness in pixels.
Disable border by setting to 0.
-.It Cm bar_color Ns Bq Ar x
+.It Ic bar_color Ns Bq Ar x
Color of the status bar window in screen
.Ar x .
-.It Cm bar_font_color Ns Bq Ar x
+.It Ic bar_delay
+Update frequency, in seconds, of external script that populates the status bar.
+.It Ic bar_enabled
+Enable or disable status bar.
+.It Ic bar_font
+Status bar font.
+.It Ic bar_font_color Ns Bq Ar x
Color of the font in status bar in screen
.Ar x .
-.It Cm bar_font
-Status bar font.
-.It Cm bar_action
-External script that populates additional information in the status bar,
-such as battery life.
-.It Cm bar_delay
-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
+.It Ic 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
+.It Ic bind Ns Bq Ar x
+Bind key combo to action
+.Ar x .
+See the
+.Sx BINDINGS
+section below.
+.It Ic border_width
+Set window border thickness in pixels.
+Disable all borders by setting to 0.
+.It Ic clock_enabled
Enable or disable displaying the clock in the status bar.
Disable by setting to 0
so a custom clock could be used in the
.Pa bar_action
script.
-.It Cm dialog_ratio
+.It Ic color_focus
+Border color of the currently focussed window.
+.It Ic color_unfocus
+Border color of unfocussed windows.
+.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.
For example, 0.6 is 60% of the physical screen size.
-.It Cm keyboard_mapping
+.It Ic disable_border
+Remove border when bar is disabled and there is only one window on the screen.
+.It Ic focus_mode
+Using a value of
+.Pa follow_cursor
+will make the window manager focus the window
+under the mouse when switching workspaces and creating windows.
+.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.
See the
.Sx KEYBOARD MAPPING FILES
section below for a list of keyboard mapping files that have been provided
for several keyboard layouts.
-.It Cm layout
+.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.
option.
.Pp
This setting is not retained at restart.
-.It Cm region
+.It Ic modkey
+Change mod key.
+Mod1 is generally the ALT key and Mod4 is the windows key on a PC.
+.It Ic program Ns Bq Ar p
+Define new action to spawn a program
+.Ar p .
+See the
+.Sx PROGRAMS
+section below.
+.It Ic quirk Ns Bq Ar c:n
+Add "quirk" for windows with class
+.Ar c
+and name
+.Ar n .
+See the
+.Sx QUIRKS
+section below.
+.It Ic region
Allocates a custom region, removing any autodetected regions which occupy the same
space on the screen.
Defined in the format screen[<idx>]:WIDTHxHEIGHT+X+Y,
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 Cm term_width
+.It Ic stack_enabled
+Enable or disable displaying the current stacking algorithm in the status bar.
+.It Ic term_width
Set a preferred minimum width for the terminal.
If this value is greater than 0,
.Nm
section) to use an alternate copy of the
.Xr xterm 1
binary without the setgid bit set.
-.It Cm title_class_enabled
+.It Ic title_class_enabled
Enable or disable displaying the window class in the status bar.
Enable by setting to 1.
-.It Cm title_name_enabled
+.It Ic title_name_enabled
Enable or disable displaying the window title in the status bar.
Enable by setting to 1.
-.It Cm urgent_enabled
+.It Ic urgent_enabled
Enable or disable the urgency hint.
Note that many terminal emulators require this to be enabled for it to
propagate.
.Pa xterm.urgentOnBell: true
to
.Pa .Xdefaults .
-.It Cm window_name_enabled
-Enable or disable displaying the window name in the status bar.
-Enable by setting to 1.
-.It Cm verbose_layout
+.It Ic verbose_layout
Enable or disable displaying the current master and stack values in the status
bar.
Enable by setting to 1.
-.It Cm modkey
-Change mod key.
-Mod1 is generally the ALT key and Mod4 is the windows key on a PC.
-.It Cm focus_mode
-Using a value of
-.Pa follow_cursor
-will make the window manager focus the window
-under the mouse when switching workspaces and creating windows.
-.It Cm disable_border
-Remove border when bar is disabled and there is only one window on the screen.
-.It Cm border_width
-Set window border thickness in pixels.
-Disable all borders by setting to 0.
-.It Cm program Ns Bq Ar p
-Define new action to spawn a program
-.Ar p .
-See the
-.Sx PROGRAMS
-section below.
-.It Cm bind Ns Bq Ar x
-Bind key combo to action
-.Ar x .
-See the
-.Sx BINDINGS
-section below.
-.It Cm quirk Ns Bq Ar c:n
-Add "quirk" for windows with class
-.Ar c
-and name
-.Ar n .
-See the
-.Sx QUIRKS
-section below.
+.It Ic window_name_enabled
+Enable or disable displaying the window name in the status bar.
+Enable by setting to 1.
.El
.Pp
Colors need to be specified per the
Example:
.Bd -literal -offset indent
program[ff] = /usr/local/bin/firefox http://scrotwm.org/
-bind[ff] = Mod+f # Now Mod+F launched firefox
+bind[ff] = Mod+Shift+b # Now Mod+Shift+B launches firefox
.Ed
.Pp
To undo the previous:
.Bd -literal -offset indent
-bind[] = Mod+f
+bind[] = Mod+Shift+b
program[ff] =
.Ed
.Sh BINDINGS
restart
.It Cm M- Ns Aq Cm Space
cycle_layout
+.It Cm M-S- Ns Aq Cm \e
+flip_layout
.It Cm M-S- Ns Aq Cm Space
-reset_layout
+stack_reset
.It Cm M-h
master_shrink
.It Cm M-l
width_shrink
.It Cm M-=
width_grow
-.It Cm M-S-
+.It Cm M-S--
height_shrink
.It Cm M-S-=
height_grow
name_workspace
.It Cm M-/
search_workspace
+.It Cm M-f
+search_win
.El
.Pp
The action names and descriptions are listed below:
.Nm .
.It Cm cycle_layout
Cycle layout.
-.It Cm reset_layout
+.It Cm flip_layout
+Swap the master and stacking areas.
+.It Cm stack_reset
Reset layout.
.It Cm master_shrink
Shrink master area.
Name the current workspace.
.It Cm search_workspace
Search for a workspace.
+.It Cm search_win
+Search the windows in the current workspace.
.El
.Pp
Custom bindings in the configuration file are specified as follows:
bind[] = Mod1+q # unbind Alt + q
.Ed
.Pp
+To use the currently defined
+.Ic modkey ,
+specify MOD as the modifier key.
+.Pp
Multiple key combinations may be bound to the same action.
.Sh KEYBOARD MAPPING FILES
Keyboard mapping files for several keyboard layouts are listed
Spanish keyboard layout
.It Cm scrotwm_fr.conf
French keyboard layout
+.It Cm scrotwm_fr_ch.conf
+Swiss French keyboard layout
+.It Cm scrotwm_se.conf
+Swedish keyboard layout
.It Cm scrotwm_us.conf
United States keyboard layout
.El
.Aq class
and
.Aq name
-by running xprop(1) and then clicking on the desired window.
+by running
+.Xr xprop 1
+and then clicking on the desired window.
In the following example the main window of Firefox was clicked:
.Bd -literal -offset indent
$ xprop | grep WM_CLASS
.It Cm Pierre-Yves Ritschard Aq pyr@spootnik.org
.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
.El
-.Sh BUGS
-Currently the menu, invoked with
-.Cm M-p ,
-depends on dmenu.
Got questions, comments, patches, etc.? Contact Jason Woofenden