.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 \-sessionname session_name
Set session name. This option affects where workspace and other save files are
put (~/.pwm3/session_name if option set).
.TP
.B \-xinerama 0|1
If Ioncore was compiled with Xinerama support, this option can be used to
enable/disable (1/0) the use of it. The default is _not_ to use Xinerama
screen information.
.TP
.B \-help
Show help on command line options
.TP
.B \-version
Show version
.TP
.B \-about
Show about text (version, copyright)

.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 both frames and screens and their children

BINDINGS:WMPlex

.SS Bindings operating on frames and their children

BINDINGS:WFrame

.SS Move/resize mode bindings

BINDINGS:WMoveresMode

.SS Bindings for floating workspaces and frames [mod_floatws]

BINDINGS:WGroupWS

BINDINGS:WFloatFrame

.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>.