mirror of
git://git.suckless.org/dwm
synced 2024-12-18 13:14:59 +00:00
141 lines
2.7 KiB
Groff
141 lines
2.7 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 X11. 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
|
|
has a small status bar which displays the text read from standard
|
|
input, if written. Besides that, it displays all available tags, and the title
|
|
of the focused window. It draws a 1-pixel border around windows to
|
|
indicate the focus state. Unfocused windows contain a small bar in front of
|
|
them displaying their tags and 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 .
|
|
.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-Return
|
|
Zoom current
|
|
.B window
|
|
to the
|
|
.B master
|
|
column.
|
|
.TP
|
|
.B Mod1-j
|
|
Focus next
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-k
|
|
Focus previous
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-m
|
|
Maximize current
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-[0..n]
|
|
View all windows with
|
|
.BR "tag n" .
|
|
.TP
|
|
.B Mod1-space
|
|
Toggle between
|
|
.B tiled
|
|
and
|
|
.B floating
|
|
mode (affects
|
|
.BR "all windows" ).
|
|
.TP
|
|
.B Mod1-Shift-[0..n]
|
|
Apply
|
|
.B nth tag
|
|
to current
|
|
.BR window .
|
|
.TP
|
|
.B Mod1-Shift-c
|
|
Close focused
|
|
.B window.
|
|
.TP
|
|
.B Mod1-Shift-q
|
|
Quit
|
|
.B dwm.
|
|
.TP
|
|
.B Mod1-Shift-Return
|
|
Start
|
|
.BR terminal .
|
|
.TP
|
|
.B Mod1-Control-[0..n]
|
|
Add/remove all windows with
|
|
.B tag n
|
|
to/from the view.
|
|
.TP
|
|
.B Mod1-Control-Shift-[0..n]
|
|
Add/remove
|
|
.B nth tag
|
|
to/from current
|
|
.BR window .
|
|
.SS Mouse commands
|
|
.TP
|
|
.B Mod1-Button1
|
|
Move current
|
|
.B window
|
|
while dragging.
|
|
.TP
|
|
.B Mod1-Button2
|
|
Zoom current
|
|
.B window
|
|
to the
|
|
.B master
|
|
column.
|
|
.TP
|
|
.B Mod1-Button3
|
|
Resize current
|
|
.B window
|
|
while dragging.
|
|
.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 displays
|
|
.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)
|