aewl

annotate dwm.1 @ 279:2cedfbefd025

find changesets by author, revision, files, or words in the commit message
added mappingnotify event for kb refreshes
author Anselm R.Garbe <arg@10ksloc.org>
date Mon, 14 Aug 2006 16:08:52 +0200
parents 8a8ea74e1b87
children b7865e6feef2
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
garbeam@82 9 is a dynamic window manager for X11. 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@174 24 has a small status bar which displays the text read from standard
arg@174 25 input, if written. Besides that, it displays all available tags, and the title
arg@174 26 of the focused window. It draws a 1-pixel border around windows to
arg@174 27 indicate the focus state. Unfocused windows contain a small bar in front of
arg@174 28 them displaying their tags and title.
garbeam@80 29 .SH OPTIONS
garbeam@0 30 .TP
garbeam@0 31 .B \-v
garbeam@80 32 prints version information to standard output, then exits.
garbeam@82 33 .SH USAGE
arg@256 34 .SS Status bar
arg@256 35 .TP
arg@259 36 .B Standard input
arg@259 37 is read and displayed in the status text area.
arg@256 38 .TP
arg@270 39 .B Button[1,2]
arg@262 40 click on a tag label focuses that
arg@262 41 .B tag.
arg@262 42 .TP
arg@270 43 .B Button3
arg@264 44 click on a tag label toggles that
arg@262 45 .B tag.
arg@256 46 .SS Keyboard commands
garbeam@55 47 .TP
garbeam@55 48 .B Mod1-Return
arg@238 49 Zoom current
garbeam@55 50 .B window
garbeam@55 51 to the
garbeam@55 52 .B master
arg@219 53 column.
garbeam@55 54 .TP
arg@160 55 .B Mod1-j
arg@160 56 Focus next
arg@219 57 .B window.
arg@160 58 .TP
garbeam@55 59 .B Mod1-k
garbeam@55 60 Focus previous
arg@219 61 .B window.
garbeam@55 62 .TP
garbeam@55 63 .B Mod1-m
garbeam@55 64 Maximize current
arg@219 65 .B window.
garbeam@55 66 .TP
garbeam@55 67 .B Mod1-[0..n]
garbeam@55 68 Focus
arg@219 69 .B nth tag.
garbeam@55 70 .TP
garbeam@55 71 .B Mod1-space
arg@143 72 Toggle between
arg@143 73 .B tiled
arg@143 74 and
arg@143 75 .B floating
arg@143 76 mode (affects
arg@219 77 .BR "all windows" ).
garbeam@56 78 .TP
garbeam@56 79 .B Mod1-Shift-[0..n]
garbeam@56 80 Apply
arg@160 81 .B nth tag
arg@160 82 to current
arg@219 83 .B window.
garbeam@56 84 .TP
arg@258 85 .B Mod1-Shift-c
arg@258 86 Close focused
arg@258 87 .B window.
arg@258 88 .TP
garbeam@56 89 .B Mod1-Shift-q
garbeam@56 90 Quit
arg@219 91 .B dwm.
garbeam@56 92 .TP
garbeam@56 93 .B Mod1-Shift-Return
garbeam@56 94 Start
arg@219 95 .B terminal.
garbeam@56 96 .TP
arg@131 97 .B Mod1-Control-[0..n]
arg@264 98 Toggle
arg@264 99 .B nth tag.
arg@264 100 .TP
arg@264 101 .B Mod1-Control-Shift-[0..n]
garbeam@56 102 Append
arg@160 103 .B nth tag
arg@160 104 to current
arg@219 105 .B window.
arg@256 106 .SS Mouse commands
garbeam@82 107 .TP
garbeam@59 108 .B Mod1-Button1
arg@238 109 Move current
garbeam@59 110 .B window
arg@219 111 while dragging.
garbeam@59 112 .TP
arg@238 113 .B Mod1-Button2
arg@238 114 Zoom current
arg@238 115 .B window
arg@238 116 to the
arg@238 117 .B master
arg@238 118 column.
arg@238 119 .TP
garbeam@59 120 .B Mod1-Button3
arg@238 121 Resize current
garbeam@59 122 .B window
arg@219 123 while dragging.
garbeam@82 124 .SH CUSTOMIZATION
garbeam@82 125 .B dwm
arg@174 126 is customized by creating a custom config.h and (re)compiling the source
arg@174 127 code. This keeps it fast, secure and simple.
arg@264 128 .SH CAVEATS
arg@264 129 The status bar displays
arg@264 130 .BR "broken pipe"
arg@264 131 when
arg@264 132 .B dwm
arg@264 133 has been started by
arg@264 134 .BR xdm (1),
arg@264 135 because it closes standard output before executing
arg@264 136 .B dwm.
arg@201 137 .SH SEE ALSO
arg@201 138 .BR dmenu (1)