mirror of git://git.suckless.org/dwm
166 lines
3.0 KiB
Groff
166 lines
3.0 KiB
Groff
.TH DWM 1 dwm-VERSION
|
|
.SH NAME
|
|
dwm \- dynamic window manager
|
|
.SH SYNOPSIS
|
|
.B dwm
|
|
.RB [ \-v ]
|
|
.SH DESCRIPTION
|
|
.B dwm
|
|
is a dynamic window manager for X. It manages windows in tiling and floating
|
|
modes. Either mode can be applied dynamically, optimizing the environment for
|
|
the application in use and the task performed.
|
|
.P
|
|
In tiling mode windows are managed in a master and stacking column. The master
|
|
column contains the window which currently needs most attention, whereas the
|
|
stacking column contains all other windows. In floating mode windows can be
|
|
resized and moved freely. Dialog windows are always managed floating,
|
|
regardless of the mode selected.
|
|
.P
|
|
Windows are grouped by tags. Each window can be tagged with one or multiple
|
|
tags. Selecting a certain tag for viewing will display all windows with that
|
|
tag.
|
|
.P
|
|
.B dwm
|
|
contains a small status bar which displays all available tags, the mode, the
|
|
title of the focused window, and the text read from standard input. The tags of
|
|
the focused window are highlighted with a small point.
|
|
.P
|
|
.B dwm
|
|
draws a 1-pixel border around windows to indicate the focus state.
|
|
Unfocused windows contain a small bar in front of them displaying their title.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-v
|
|
prints version information to standard output, then exits.
|
|
.SH USAGE
|
|
.SS Status bar
|
|
.TP
|
|
.B Standard input
|
|
is read and displayed in the status text area.
|
|
.TP
|
|
.B Button1
|
|
click on a tag label views all windows with that
|
|
.BR tag ,
|
|
click on the mode label toggles between
|
|
.B tiled
|
|
and
|
|
.B floating
|
|
mode.
|
|
.TP
|
|
.B Button2
|
|
click on a tag label adds/removes that
|
|
.B tag
|
|
to/from the focused
|
|
.B window.
|
|
.TP
|
|
.B Button3
|
|
click on a tag label adds/removes all windows with that
|
|
.B tag
|
|
to/from the view.
|
|
.SS Keyboard commands
|
|
.TP
|
|
.B Mod1-Shift-Return
|
|
Start
|
|
.BR xterm (1).
|
|
.TP
|
|
.B Mod1-Tab
|
|
Focus next
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Shift-Tab
|
|
Focus previous
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Return
|
|
Zoom current
|
|
.B window
|
|
to the
|
|
.B master
|
|
column
|
|
.RB ( tiling
|
|
mode only).
|
|
.TP
|
|
.B Mod1-m
|
|
Maximize current
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Shift-[1..n]
|
|
Apply
|
|
.B nth tag
|
|
to current
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Control-Shift-[1..n]
|
|
Add/remove
|
|
.B nth tag
|
|
to/from current
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Shift-c
|
|
Close focused
|
|
.B window.
|
|
.TP
|
|
.B Mod1-space
|
|
Toggle between
|
|
.B tiled
|
|
and
|
|
.B floating
|
|
mode (affects
|
|
.BR "all windows" ).
|
|
.TP
|
|
.B Mod1-[1..n]
|
|
View all windows with
|
|
.BR "tag n" .
|
|
.TP
|
|
.B Mod1-0
|
|
View all windows with any
|
|
.BR "tag" .
|
|
.TP
|
|
.B Mod1-Control-[1..n]
|
|
Add/remove all windows with
|
|
.B tag n
|
|
to/from the view.
|
|
.TP
|
|
.B Mod1-Shift-q
|
|
Quit
|
|
.B dwm.
|
|
.SS Mouse commands
|
|
.TP
|
|
.B Mod1-Button1
|
|
Move current
|
|
.B window
|
|
while dragging
|
|
.RB ( floating
|
|
mode only).
|
|
.TP
|
|
.B Mod1-Button2
|
|
Zoom current
|
|
.B window
|
|
to the
|
|
.B master
|
|
column
|
|
.RB ( tiling
|
|
mode only).
|
|
.TP
|
|
.B Mod1-Button3
|
|
Resize current
|
|
.B window
|
|
while dragging
|
|
.RB ( floating
|
|
mode only).
|
|
.SH CUSTOMIZATION
|
|
.B dwm
|
|
is customized by creating a custom config.h and (re)compiling the source
|
|
code. This keeps it fast, secure and simple.
|
|
.SH CAVEATS
|
|
The status bar may display
|
|
.B broken pipe
|
|
when
|
|
.B dwm
|
|
has been started by
|
|
.BR xdm (1),
|
|
because it closes standard output before executing
|
|
.BR dwm .
|
|
.SH SEE ALSO
|
|
.BR dmenu (1)
|