dwm.1
author Anselm R.Garbe <arg@10ksloc.org>
Thu, 10 Aug 2006 10:16:12 +0200
changeset 232 98e9901b1dbb
parent 219 d8e508716aa8
child 238 969fb6be25e1
permissions -rw-r--r--
disallow zoom on maximized clients
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
212
5b13a18800de applied Sanders man page/Makefile patch
arg@10ksloc.org
parents: 201
diff changeset
     1
.TH DWM 1 dwm-VERSION
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     2
.SH NAME
39
0932ed0753dc another change
Anselm R. Garbe <garbeam@wmii.de>
parents: 38
diff changeset
     3
dwm \- dynamic window manager
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     4
.SH SYNOPSIS
38
678730a1339b updated man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     5
.B dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     6
.RB [ \-v ]
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     7
.SH DESCRIPTION
38
678730a1339b updated man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     8
.B dwm
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
     9
is a dynamic window manager for X11. It manages windows in tiling and floating
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    10
modes. Either mode can be applied dynamically, optimizing the environment for
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    11
the application in use and the task performed.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
    12
.P
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
    13
In tiling mode windows are managed in a master and stacking column. The master
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    14
column contains the window which currently needs most attention, whereas the
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    15
stacking column contains all other windows. In floating mode windows can be
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    16
resized and moved freely. Dialog windows are always managed floating,
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    17
regardless of the mode selected.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
    18
.P
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    19
Windows are grouped by tags. Each window can be tagged with one or multiple
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    20
tags. Selecting a certain tag for viewing will display all windows with that
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    21
tag.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
    22
.P
83
ca809fdd30ea slight change to dwm.1
Anselm R. Garbe <garbeam@wmii.de>
parents: 82
diff changeset
    23
.B dwm
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    24
has a small status bar which displays the text read from standard
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    25
input, if written. Besides that, it displays all available tags, and the title
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    26
of the focused window. It draws a 1-pixel border around windows to
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    27
indicate the focus state. Unfocused windows contain a small bar in front of
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
    28
them displaying their tags and title.
80
8125f908c80c several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents: 79
diff changeset
    29
.SH OPTIONS
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    30
.TP
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    31
.B \-v
80
8125f908c80c several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents: 79
diff changeset
    32
prints version information to standard output, then exits.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
    33
.SH USAGE
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    34
.TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    35
.B Mod1-Return
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    36
Zoom
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    37
.B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    38
to the 
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    39
.B master
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    40
column.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    41
.TP
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    42
.B Mod1-h
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    43
Focus previous
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    44
.B tag.
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    45
.TP
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    46
.B Mod1-j
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    47
Focus next
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    48
.B window.
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    49
.TP
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    50
.B Mod1-k
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    51
Focus previous
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    52
.B window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    53
.TP
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    54
.B Mod1-l
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    55
Focus next
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    56
.B tag.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    57
.TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    58
.B Mod1-m
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    59
Maximize current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    60
.B window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    61
.TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    62
.B Mod1-[0..n]
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    63
Focus
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    64
.B nth tag.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    65
.TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
    66
.B Mod1-space
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
    67
Toggle between
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
    68
.B tiled
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
    69
and
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
    70
.B floating
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
    71
mode (affects
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    72
.BR "all windows" ).
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    73
.TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    74
.B Mod1-Shift-[0..n]
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    75
Apply
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    76
.B nth tag
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    77
to current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    78
.B window.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    79
.TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    80
.B Mod1-Shift-q
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    81
Quit
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    82
.B dwm.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    83
.TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    84
.B Mod1-Shift-Return
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    85
Start
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    86
.B terminal.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    87
.TP
131
65efe27cbf3d preparing 0.6 which will be available in the evening after sanders patch approx.
arg@10ksloc.org
parents: 123
diff changeset
    88
.B Mod1-Control-[0..n]
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
    89
Append
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    90
.B nth tag
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
    91
to current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    92
.B window.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
    93
.TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
    94
.B Mod1-Button1
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
    95
Moves current
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
    96
.B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
    97
while dragging.
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
    98
.TP
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
    99
.B Mod1-Button3
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
   100
Resizes current
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
   101
.B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
   102
while dragging.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
   103
.SH CUSTOMIZATION
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
   104
.B dwm
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
   105
is customized by creating a custom config.h and (re)compiling the source
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
   106
code. This keeps it fast, secure and simple.
201
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
   107
.SH SEE ALSO
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
   108
.BR dmenu (1)