.Os
.Sh NAME
.Nm scrotwm
-.Nd is a small dynamic tiling window manager for X11.
+.Nd small dynamic tiling window manager for X11.
.Sh SYNOPSIS
.Nm scrotwm
.Sh DESCRIPTION
Shift
.It Ic [Name]
Named key
+.It Ic M1
+Mouse button 1
.El
.Pp
.Nm
Switch to next workspace with a window in it.
.It Ic M-[LeftArrow]
Switch to previous workspace with a window in it.
+.It Ic M-s
+Take screenshot of entire screen (if enabled).
+.It Ic M-S-s
+Take screenshot of selected window (if enabled).
+.It Ic M1
+Focus window.
.El
.Pp
.Pp
.Sh FILES
.Bl -tag -width Ds
.It Pa ~/.scrotwm.conf
+This file contains user specific settings.
.It Pa /etc/scrotwm.conf
+This file contains global settings.
.El
+.Pp
+.Nm
+first tries to open the user specific file.
+If that file is unavailable it tries to open the global file next.
+.Pp
+The format of the file is <keyword> = <setting>.
+E.g. color_focus = red.
+.Pp
+Enabling or disabling an option is done by using 1 or 0 respectively.
+.Pp
+The file supports the following keywords:
+.Bl -tag -width "C-M-EscapeXXX" -offset indent -compact
+.It Ic color_focus
+Border color of the currently focussed window.
+.It Ic color_unfocus
+Border color of unfocussed windows.
+.It Ic bar_enabled
+Enable or disable status bar.
+.It Ic bar_border[x]
+Color of the status bar border in screen x.
+.It Ic bar_color[x]
+Color of the status bar window in screen x.
+.It Ic bar_font_color[x]
+Color of the font in status bar in screen x.
+.It Ic bar_font
+Status bar font.
+.It Ic bar_action
+External script that populates additional information in the status bar such as
+battery life etc.
+.It Ic bar_delay
+Update frequency, in seconds, of external script that populates the status bar.
+.It Ic spawn_term
+External application that gets spawned when M-S-[Return] is used.
+.It Ic dialog_ratio
+Some applications have dialog windows that are too small to be useful.
+This ratio is the screen size as to what they will be resized.
+E.g 0.6 is 60% of the physical screen size.
+.It Ic screenshot_enabled
+Enable or disable screenshot capability.
+.It Ic screenshot_app
+Set to the script that will take screenshots.
+It will be called with "full" or "window" as parameter 1 to indicate what
+screenshot action is expected.
+The script shall handle those cases accordingly.
+.El
+.Pp
+Colors need to be specified per the
+.Xr XQueryColor 4
+specification and fonts need to be specified per the
+.Xr XQueryFont 4
+specification.
+.Sh BUGS
+Currently the menu, invoked with M-p, depends on dmenu.
.Sh AUTHORS
.An -nosplit
.Pp
.Sh HISTORY
.Nm
was inspired by xmonad & dwm.
-.Pp
-.Nm
-first appeared in
-.Ox 4.5 .