.TH PWM 1
.SH NAME
PWM - An X11 window manager
.SH SYNOPSIS
.B pwm3
.I "[options]"
.SH "DESCRIPTION"

The original PWM was the first tabbing window manager. This version of
PWM is based on the code of Ion and is actually exactly the same window
manager with only differences in default configuration files, configuration
file lookup paths and some options.

.SH "OPTIONS"
.TP
.B \-display host:display.screen
X display to manage
.TP
.B \-conffile configfile
Configuration file to use instead of default
.TP
.B \-searchdir dir
Directory to search for configuration files and other scripts
.TP
.B \-oneroot
On X servers with multiple (traditional non-Xinerama) screens, manage only
default screen (root window), not all, as given by the -display option or
in the DISPLAY environment variable.
.TP
.B \-session session_name
Set session name. This option affects where workspace and other save files are
put (~/.pwm3/session_name if option set).
.TP
.B \-help
Show help on command line options
.TP
.B \-version
Show version
.TP
.B \-about
Show about text (version, author, license)

.SH BINDINGS

These are the default key and pointer bindings. (\fBMod1\fP) depends on your
system. On PC:s with XFree86 it is probably bound to the left Alt key
(\fBAlt_L\fP). On Suns it is usually bound to the diamond keys
(\fBMeta_L\fP, \fBMeta_R\fP). Use \fIxmodmap(1x)\fP to find out.

The string in square brackets after a binding group heading below indicates
the module that whose configuration file defines these bindings.

.SS Globally available bindings

BINDINGS:WScreen

.SS Bindings operating on all frames and screens and their children

BINDINGS:WMPlex

.SS Bindings operating on all frames and their children

BINDINGS:WFrame
BINDINGS:WFrame.floating

.SS Bindings operating on top-level (non-transient) frames as well as screens

BINDINGS:WMPlex.toplevel

.SS Bindings operating on top-level (non-transient) frames

BINDINGS:WFrame.toplevel

.SS Bindings for client windows

BINDINGS:WClientWin
BINDINGS:WGroupCW

.SS Move/resize mode bindings

BINDINGS:WMoveresMode

.SS Bindings for menus [mod_menu]

BINDINGS:WMenu


.SH FILES AND DIRECTORIES
.TP
.B ETCDIR/cfg_pwm.lua
System default main configuration file
.TP
.B ETCDIR/cfg_*.lua
Other configuration files
.TP
.B ETCDIR/look_*.lua
Colour scheme configuration files
.TP
.B ~/.pwm3/
User configuration files
.TP
.B ~/.pwm3/cfg_pwm.lua
User default main configuration file (overrides system default)

.SH SEE ALSO

For more information, see
\fIion3(1)\fP.

.SH AUTHOR
Both PWM and Ion have been written by Tuomo Valkonen <tuomov at iki.fi>.