Cleaned up and updated man page for DWM
This will provide up to date references to my key bindings!
This commit is contained in:
267
dwm.1
267
dwm.1
@@ -5,29 +5,59 @@ dwm \- dynamic window manager
|
||||
.B dwm
|
||||
.RB [ \-v ]
|
||||
.SH DESCRIPTION
|
||||
dwm is a dynamic window manager for X. It manages windows in tiled, monocle
|
||||
and floating layouts. Either layout can be applied dynamically, optimising the
|
||||
environment for the application in use and the task performed.
|
||||
dwm is a dynamic window manager for X. It manages windows in a
|
||||
variety of layouts:
|
||||
.nr PI 1n
|
||||
.IP \[bu]
|
||||
floating: windows can be resized and moved freely, a la usual window
|
||||
managers.
|
||||
.IP \[bu]
|
||||
tiled: windows are managed in a master and stacking area. The master
|
||||
area on the left contains one window by default, and the stacking area
|
||||
on the right contains all other windows. The number of master area
|
||||
windows can be adjusted from zero to an arbitrary number.
|
||||
.IP \[bu]
|
||||
monocle (normal, centred or floating)
|
||||
|
||||
Normal: all windows are maximised to the screen size.
|
||||
|
||||
Centred: the screen is split into three sections with the master
|
||||
clients getting the second section and the stacking clients get the
|
||||
remaining 2 sections to be laid out in.
|
||||
|
||||
Floating: the master clients are placed floating in the centre of the
|
||||
screen while the remaining stacking clients are placed side by side
|
||||
vertically.
|
||||
.IP \[bu]
|
||||
fibonacci (dwindle and spiral): windows are tiled in a spiralling or
|
||||
dwindling pattern.
|
||||
|
||||
In the dwindle layout new clients tend towards the bottom left of the
|
||||
monitor while in the spiral layout clients tend towards the centre
|
||||
bottom left.
|
||||
.IP \[bu]
|
||||
deck: the stacking clients are placed floating on top of each other
|
||||
such that there are only two partitions of the screen space.
|
||||
.IP \[bu]
|
||||
gapless grid: n clients are arranged into a square of ceil(sqrt(n))
|
||||
length, where the top left is the latest client opened.
|
||||
.P
|
||||
In tiled layouts windows are managed in a master and stacking area. The master
|
||||
area on the left contains one window by default, and the stacking area on the
|
||||
right contains all other windows. The number of master area windows can be
|
||||
adjusted from zero to an arbitrary number. In monocle layout all windows are
|
||||
maximised to the screen size. In floating layout windows can be resized and
|
||||
moved freely. Dialog windows are always managed floating, regardless of the
|
||||
layout applied.
|
||||
Dialog windows are always managed floating, regardless of the layout
|
||||
applied.
|
||||
.P
|
||||
Windows are grouped by tags. Each window can be tagged with one or multiple
|
||||
tags. Selecting certain tags displays all windows with these tags.
|
||||
Windows are grouped by tags. Each window can be tagged with one or
|
||||
multiple tags. Selecting certain tags displays all windows with these
|
||||
tags.
|
||||
.P
|
||||
Each screen contains a small status bar which displays all available tags, the
|
||||
layout, the title of the focused window, and the text read from the root window
|
||||
name property, if the screen is focused. A floating window is indicated with an
|
||||
empty square and a maximised floating window is indicated with a filled square
|
||||
before the windows title. The selected tags are indicated with a different
|
||||
color. The tags of the focused window are indicated with a filled square in the
|
||||
top left corner. The tags which are applied to one or more windows are
|
||||
indicated with an empty square in the top left corner.
|
||||
Each screen contains a small status bar which displays all available
|
||||
tags, the layout, the title of the focused window, and the text read
|
||||
from the root window name property, if the screen is focused. A
|
||||
floating window is indicated with an empty square and a maximised
|
||||
floating window is indicated with a filled square before the windows
|
||||
title. The selected tags are indicated with a different color. The
|
||||
tags of the focused window are indicated with a filled square in the
|
||||
top left corner. The tags which are applied to one or more windows
|
||||
are indicated with an empty square in the top left corner.
|
||||
.P
|
||||
dwm draws a small border around windows to indicate the focus state.
|
||||
.SH OPTIONS
|
||||
@@ -39,119 +69,172 @@ prints version information to stderr, then exits.
|
||||
.TP
|
||||
.B X root window name
|
||||
is read and displayed in the status text area. It can be set with the
|
||||
.BR xsetroot (1)
|
||||
.BR xsetroot (1). This fork uses dwmblocks to generate system status information.
|
||||
command.
|
||||
.TP
|
||||
.B Button1
|
||||
click on a tag label to display all windows with that tag, click on the layout
|
||||
label toggles between tiled and floating layout.
|
||||
.TP
|
||||
.B Button3
|
||||
click on a tag label adds/removes all windows with that tag to/from the view.
|
||||
.TP
|
||||
.B Mod1\-Button1
|
||||
click on a tag label applies that tag to the focused window.
|
||||
.TP
|
||||
.B Mod1\-Button3
|
||||
click on a tag label adds/removes that tag to/from the focused window.
|
||||
.SS Keyboard commands
|
||||
Mod is set to Super (the "windows" key).
|
||||
.TP
|
||||
.B Mod1\-Shift\-Return
|
||||
Start
|
||||
.BR st(1).
|
||||
.B Mod\-b
|
||||
Toggle status bar
|
||||
|
||||
.TP
|
||||
.B Mod1\-p
|
||||
Spawn
|
||||
.BR dmenu(1)
|
||||
for launching other programs.
|
||||
.B Mod\-`
|
||||
Toggle scratchpad terminal (set to
|
||||
.BR st(1)
|
||||
)
|
||||
|
||||
.TP
|
||||
.B Mod1\-,
|
||||
Focus previous screen, if any.
|
||||
.B Mod\-j
|
||||
Focus next window
|
||||
|
||||
.TP
|
||||
.B Mod1\-.
|
||||
Focus next screen, if any.
|
||||
.B Mod\-k
|
||||
Focus previous window
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-,
|
||||
Send focused window to previous screen, if any.
|
||||
.B Mod\-.
|
||||
Increase gap size
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-.
|
||||
Send focused window to next screen, if any.
|
||||
.B Mod\-,
|
||||
Decrease gap size
|
||||
|
||||
.TP
|
||||
.B Mod1\-b
|
||||
Toggles bar on and off.
|
||||
.B Mod\-/
|
||||
Toggle gaps
|
||||
|
||||
.TP
|
||||
.B Mod1\-t
|
||||
Sets tiled layout.
|
||||
.B Mod\-Shift\-/
|
||||
Print current gap value (using
|
||||
.BR notify-send(1)
|
||||
)
|
||||
|
||||
.TP
|
||||
.B Mod1\-f
|
||||
Sets floating layout.
|
||||
.B Mod\-h
|
||||
Decrease size of master area
|
||||
|
||||
.TP
|
||||
.B Mod1\-m
|
||||
Sets monocle layout.
|
||||
.B Mod\-l
|
||||
Increase size of master are
|
||||
|
||||
.TP
|
||||
.B Mod1\-space
|
||||
Toggles between current and previous layout.
|
||||
.B Mod\-Control\-.
|
||||
Decrease number of master clients
|
||||
|
||||
.TP
|
||||
.B Mod1\-j
|
||||
Focus next window.
|
||||
.B Mod\-Control\-,
|
||||
Increase number of master clients
|
||||
|
||||
.TP
|
||||
.B Mod1\-k
|
||||
Focus previous window.
|
||||
.B Mod\-Shift\-h
|
||||
Rotate the stack clockwise but keep focus on the same position.
|
||||
|
||||
.TP
|
||||
.B Mod1\-i
|
||||
Increase number of windows in master area.
|
||||
.B Mod\-Shift\-l
|
||||
Rotate the stack anticlockwise but keep focus on the same position.
|
||||
|
||||
.TP
|
||||
.B Mod1\-d
|
||||
Decrease number of windows in master area.
|
||||
.B Mod\-Shift\-k
|
||||
Rotate the master clients clockwise but keep focus on the same position.
|
||||
|
||||
.TP
|
||||
.B Mod1\-l
|
||||
Increase master area size.
|
||||
.B Mod\-Shift\-j
|
||||
Rotate the master clients anticlockwise but keep focus on the same position.
|
||||
|
||||
.TP
|
||||
.B Mod1\-h
|
||||
Decrease master area size.
|
||||
.B Mod\-c
|
||||
If in stack area, swap currently focused client with master. If in master area, swap currently focused client with top of stack area.
|
||||
|
||||
.TP
|
||||
.B Mod1\-Return
|
||||
Zooms/cycles focused window to/from master area (tiled layouts only).
|
||||
.B Mod\-Shift\-t
|
||||
Set layout to tiling
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-c
|
||||
Close focused window.
|
||||
.B Mod\-Shift\-f
|
||||
Set layout to floating
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-space
|
||||
Toggle focused window between tiled and floating state.
|
||||
.B Mod\-Shift\-m
|
||||
Set layout to monocle
|
||||
|
||||
.TP
|
||||
.B Mod1\-Tab
|
||||
Toggles to the previously selected tags.
|
||||
.B Mod\-Shift\-u
|
||||
Set layout to centred monocle
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-[1..n]
|
||||
Apply nth tag to focused window.
|
||||
.B Mod\-Shift\-o
|
||||
Set layout to centred floating monocle
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-0
|
||||
Apply all tags to focused window.
|
||||
.B Mod\-Shift\-s
|
||||
Set layout to spiral fibonacci
|
||||
|
||||
.TP
|
||||
.B Mod1\-Control\-Shift\-[1..n]
|
||||
Add/remove nth tag to/from focused window.
|
||||
.B Mod\-Shift\-d
|
||||
Set layout to dwindle fibonacci
|
||||
|
||||
.TP
|
||||
.B Mod\-Shift\-g
|
||||
Set layout to gapless grid
|
||||
|
||||
.TP
|
||||
.B Mod\-Shift\-i
|
||||
Set layout to deck
|
||||
|
||||
.TP
|
||||
.B Mod\-Shift\-space
|
||||
Toggle between current layout and previous layout
|
||||
|
||||
.TP
|
||||
.B Mod\-space
|
||||
Toggle current client's floating (floating -> not floating, not floating -> floating)
|
||||
|
||||
.TP
|
||||
.B Mod1\-[1..n]
|
||||
View all windows with nth tag.
|
||||
Go to nth tag
|
||||
|
||||
.TP
|
||||
.B Mod1\-0
|
||||
View all windows with any tag.
|
||||
.B Mod1\-Shift\-[1..n]
|
||||
Send focused client to nth tag.
|
||||
|
||||
.TP
|
||||
.B Mod1\-Control\-[1..n]
|
||||
Add/remove all windows with nth tag to/from the view.
|
||||
.B Mod\-m
|
||||
Focus on the next monitor in monitor stack
|
||||
|
||||
.TP
|
||||
.B Mod1\-Shift\-q
|
||||
Quit dwm.
|
||||
.B Mod\-Shift\-,
|
||||
Send client to previous monitor in monitor stack
|
||||
|
||||
.TP
|
||||
.B Mod\-Shift\-.
|
||||
Send client to next monitor in monitor stack
|
||||
|
||||
.TP
|
||||
.B Mod\-Tab
|
||||
View the previous tag
|
||||
|
||||
.TP
|
||||
.B Mod\-q
|
||||
Kill the currently focused client
|
||||
|
||||
.TP
|
||||
.B Mod\-Shift\-q
|
||||
Kill dwm
|
||||
|
||||
.SS Mouse commands
|
||||
|
||||
.TP
|
||||
.B Mod1\-Button1
|
||||
Move focused window while dragging. Tiled windows will be toggled to the floating state.
|
||||
|
||||
.TP
|
||||
.B Mod1\-Button2
|
||||
Toggles focused window between floating and tiled state.
|
||||
|
||||
.TP
|
||||
.B Mod1\-Button3
|
||||
Resize focused window while dragging. Tiled windows will be toggled to the floating state.
|
||||
|
||||
.SH CUSTOMIZATION
|
||||
dwm is customized by creating a custom config.h and (re)compiling the source
|
||||
code. This keeps it fast, secure and simple.
|
||||
|
||||
Reference in New Issue
Block a user