aewl

annotate dwm.1 @ 384:126e78129f1d

find changesets by author, revision, files, or words in the commit message
configurenotify remembers max geom now, and restores this if necessary, however it accepts to touch the max size on configurerequest, this shouldn't break fillscreen apps (tested with mplayer)
author Anselm R. Garbe <arg@10kloc.org>
date Tue, 29 Aug 2006 17:31:55 +0200
parents d955a84b7d4b
children 1da9a6b94ca9
rev   line source
arg@212 1 .TH DWM 1 dwm-VERSION
garbeam@0 2 .SH NAME
garbeam@39 3 dwm \- dynamic window manager
garbeam@0 4 .SH SYNOPSIS
garbeam@38 5 .B dwm
garbeam@0 6 .RB [ \-v ]
garbeam@0 7 .SH DESCRIPTION
garbeam@38 8 .B dwm
arg@316 9 is a dynamic window manager for X. It manages windows in tiling and floating
arg@174 10 modes. Either mode can be applied dynamically, optimizing the environment for
arg@174 11 the application in use and the task performed.
garbeam@79 12 .P
garbeam@82 13 In tiling mode windows are managed in a master and stacking column. The master
arg@174 14 column contains the window which currently needs most attention, whereas the
arg@174 15 stacking column contains all other windows. In floating mode windows can be
arg@174 16 resized and moved freely. Dialog windows are always managed floating,
arg@174 17 regardless of the mode selected.
garbeam@80 18 .P
arg@174 19 Windows are grouped by tags. Each window can be tagged with one or multiple
arg@174 20 tags. Selecting a certain tag for viewing will display all windows with that
arg@174 21 tag.
garbeam@79 22 .P
garbeam@83 23 .B dwm
arg@364 24 contains a small status bar which displays all available tags, the mode, the
arg@364 25 title of the focused window, and the text read from standard input. The tags of
arg@364 26 the focused window are highlighted with a small point.
arg@316 27 .P
arg@346 28 .B dwm
arg@346 29 draws a 1-pixel border around windows to indicate the focus state.
arg@342 30 Unfocused windows contain a small bar in front of them displaying their title.
garbeam@80 31 .SH OPTIONS
garbeam@0 32 .TP
garbeam@0 33 .B \-v
garbeam@80 34 prints version information to standard output, then exits.
garbeam@82 35 .SH USAGE
arg@256 36 .SS Status bar
arg@256 37 .TP
arg@259 38 .B Standard input
arg@259 39 is read and displayed in the status text area.
arg@256 40 .TP
arg@288 41 .B Button1
arg@288 42 click on a tag label views all windows with that
arg@371 43 .BR tag ,
arg@371 44 click on the mode label toggles between
arg@371 45 .B tiled
arg@371 46 and
arg@371 47 .B floating
arg@371 48 mode.
arg@262 49 .TP
arg@270 50 .B Button3
arg@288 51 click on a tag label adds/removes all windows with that
arg@288 52 .B tag
arg@288 53 to/from the view.
arg@256 54 .SS Keyboard commands
garbeam@55 55 .TP
arg@293 56 .B Mod1-Shift-Return
arg@293 57 Start
arg@293 58 .BR xterm (1).
arg@293 59 .TP
arg@293 60 .B Mod1-Tab
arg@293 61 Focus next
arg@293 62 .BR window .
arg@293 63 .TP
arg@293 64 .B Mod1-Shift-Tab
arg@293 65 Focus previous
arg@293 66 .BR window .
arg@293 67 .TP
garbeam@55 68 .B Mod1-Return
arg@238 69 Zoom current
garbeam@55 70 .B window
garbeam@55 71 to the
garbeam@55 72 .B master
arg@293 73 column
arg@293 74 .RB ( tiling
arg@293 75 mode only).
garbeam@55 76 .TP
garbeam@55 77 .B Mod1-m
garbeam@55 78 Maximize current
arg@288 79 .BR window .
garbeam@55 80 .TP
arg@293 81 .B Mod1-Shift-[0..n]
arg@293 82 Apply
arg@293 83 .B nth tag
arg@293 84 to current
arg@293 85 .BR window .
arg@293 86 .TP
arg@293 87 .B Mod1-Control-Shift-[0..n]
arg@293 88 Add/remove
arg@293 89 .B nth tag
arg@293 90 to/from current
arg@293 91 .BR window .
arg@293 92 .TP
arg@293 93 .B Mod1-Shift-c
arg@293 94 Close focused
arg@293 95 .B window.
garbeam@55 96 .TP
garbeam@55 97 .B Mod1-space
arg@143 98 Toggle between
arg@143 99 .B tiled
arg@143 100 and
arg@143 101 .B floating
arg@143 102 mode (affects
arg@219 103 .BR "all windows" ).
garbeam@56 104 .TP
arg@293 105 .B Mod1-[0..n]
arg@293 106 View all windows with
arg@293 107 .BR "tag n" .
garbeam@56 108 .TP
arg@131 109 .B Mod1-Control-[0..n]
arg@288 110 Add/remove all windows with
arg@288 111 .B tag n
arg@288 112 to/from the view.
arg@264 113 .TP
arg@293 114 .B Mod1-Shift-q
arg@293 115 Quit
arg@293 116 .B dwm.
arg@256 117 .SS Mouse commands
garbeam@82 118 .TP
garbeam@59 119 .B Mod1-Button1
arg@238 120 Move current
garbeam@59 121 .B window
arg@293 122 while dragging
arg@293 123 .RB ( floating
arg@293 124 mode only).
garbeam@59 125 .TP
arg@238 126 .B Mod1-Button2
arg@238 127 Zoom current
arg@238 128 .B window
arg@238 129 to the
arg@238 130 .B master
arg@293 131 column
arg@293 132 .RB ( tiling
arg@293 133 mode only).
arg@238 134 .TP
garbeam@59 135 .B Mod1-Button3
arg@238 136 Resize current
garbeam@59 137 .B window
arg@293 138 while dragging
arg@293 139 .RB ( floating
arg@293 140 mode only).
garbeam@82 141 .SH CUSTOMIZATION
garbeam@82 142 .B dwm
arg@174 143 is customized by creating a custom config.h and (re)compiling the source
arg@174 144 code. This keeps it fast, secure and simple.
arg@264 145 .SH CAVEATS
arg@347 146 The status bar may display
arg@288 147 .B broken pipe
arg@264 148 when
arg@264 149 .B dwm
arg@264 150 has been started by
arg@264 151 .BR xdm (1),
arg@264 152 because it closes standard output before executing
arg@288 153 .BR dwm .
arg@201 154 .SH SEE ALSO
arg@201 155 .BR dmenu (1)