dwm-meillo

annotate dwm.1 @ 79:aabebd6e61f3

find changesets by author, revision, files, or words in the commit message
fixed XSync handling and finished man page
author Anselm R. Garbe <garbeam@wmii.de>
date Sat, 15 Jul 2006 18:51:44 +0200
parents d31b5ad96b0b
children 8125f908c80c
rev   line source
garbeam@68 1 .TH DWM 1 dwm-0.1
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@0 8 .SS Overview
garbeam@38 9 .B dwm
garbeam@79 10 is a dynamic window manager for X11. It consists of a small status bar at the
garbeam@79 11 top of the screen and arranges windows in either a tiled or floating mode.
garbeam@79 12 .P
garbeam@79 13 If
garbeam@79 14 .B dwm
garbeam@79 15 is in tiled mode, it consists of two columns. The left master column
garbeam@79 16 contains only one window per time, the right column contains all other windows
garbeam@79 17 in a stack. In tiled mode
garbeam@79 18 .B dwm
garbeam@79 19 .B don't
garbeam@79 20 handles incremental resizals, some terminal programs like
garbeam@79 21 .B xterm
garbeam@79 22 may not work correctly with this in tiled mode.
garbeam@79 23 .P
garbeam@79 24 If
garbeam@79 25 .B dwm
garbeam@79 26 is in floating mode, it arranges all windows with the reqyested geometry and
garbeam@79 27 allows the user to move or resize them. Some windows, like
garbeam@79 28 dialog windows, are treated floating even if
garbeam@79 29 .B dwm
garbeam@79 30 is in tiled mode. In floating mode
garbeam@79 31 .B dwm
garbeam@79 32 handles incremental resizals.
garbeam@79 33 .P
garbeam@79 34 Windows are grouped by tags. You can view all windows with a specific tag per
garbeam@79 35 time. However, each window is allowed to contain more than one tag, which
garbeam@79 36 allows to make windows visible in all views.
garbeam@79 37 .P
garbeam@79 38 .B dwm
garbeam@79 39 reads from
garbeam@79 40 .I stdin
garbeam@79 41 to display status text, if written.
garbeam@79 42 .P
garbeam@79 43 .B dwm
garbeam@79 44 draws 1-pixel borders around windows to indicate the focus state and save as
garbeam@79 45 much screen real estate as possible. Unfocused windows contain a small bar
garbeam@79 46 in front of the window indicating the tags and the window title.
garbeam@0 47 .SS Options
garbeam@0 48 .TP
garbeam@0 49 .B \-v
garbeam@79 50 prints version information to
garbeam@79 51 .I stdout
garbeam@79 52 , then exits.
garbeam@79 53 .SS Customization
garbeam@58 54 .B dwm
garbeam@79 55 is customized through editing its source code. It is assumed that
garbeam@79 56 dwm users are high experienced users who know how a window manager works
garbeam@79 57 and who are able to patch
garbeam@79 58 .B dwm
garbeam@79 59 for their needs. This keeps
garbeam@79 60 .B dwm
garbeam@79 61 fast, secure and simple, because it does not process any input data, except
garbeam@79 62 window properties and the status text read from
garbeam@79 63 .I stdin .
garbeam@55 64 .SS Default Key Bindings
garbeam@55 65 .TP 16
garbeam@55 66 .I Key
garbeam@55 67 .I Action
garbeam@55 68 .TP
garbeam@55 69 .B Mod1-Return
garbeam@55 70 Zoom
garbeam@55 71 .B window
garbeam@55 72 to the
garbeam@55 73 .B master
garbeam@55 74 track
garbeam@55 75 .TP
garbeam@55 76 .B Mod1-k
garbeam@55 77 Focus previous
garbeam@55 78 .B window
garbeam@55 79 .TP
garbeam@55 80 .B Mod1-j
garbeam@55 81 Focus next
garbeam@55 82 .B window
garbeam@55 83 .TP
garbeam@55 84 .B Mod1-m
garbeam@55 85 Maximize current
garbeam@55 86 .B window
garbeam@55 87 .TP
garbeam@55 88 .B Mod1-[0..n]
garbeam@55 89 Focus
garbeam@55 90 .B nth
garbeam@55 91 tag
garbeam@55 92 .TP
garbeam@55 93 .B Mod1-space
garbeam@55 94 (Re-)arrange
garbeam@55 95 .B all
garbeam@55 96 windows tiled
garbeam@56 97 .TP
garbeam@56 98 .B Mod1-Shift-space
garbeam@56 99 (Re-)arrange
garbeam@56 100 .B all
garbeam@56 101 windows floating
garbeam@56 102 .TP
garbeam@56 103 .B Mod1-Shift-[0..n]
garbeam@56 104 Apply
garbeam@56 105 .B nth
garbeam@56 106 tag to current
garbeam@56 107 .B window
garbeam@56 108 .TP
garbeam@56 109 .B Mod1-Shift-q
garbeam@56 110 Quit
garbeam@56 111 .B dwm
garbeam@56 112 .TP
garbeam@56 113 .B Mod1-Shift-Return
garbeam@56 114 Start
garbeam@56 115 .B terminal
garbeam@56 116 .TP
garbeam@56 117 .B Mod1-Shift-w
garbeam@56 118 Start
garbeam@56 119 .B web browser
garbeam@56 120 .TP
garbeam@56 121 .B Mod1-Shift-l
garbeam@56 122 Lock
garbeam@56 123 .B screen
garbeam@56 124 .TP
garbeam@56 125 .B Control-[0..n]
garbeam@56 126 Append
garbeam@56 127 .B nth
garbeam@56 128 tag to cureent
garbeam@56 129 .B window
garbeam@59 130 .SS Default Mouse Bindings
garbeam@59 131 .TP
garbeam@59 132 .B Mod1-Button1
garbeam@59 133 Moves current
garbeam@59 134 .B window
garbeam@59 135 while dragging
garbeam@59 136 .TP
garbeam@59 137 .B Mod1-Button2
garbeam@59 138 Lowers current
garbeam@59 139 .B window
garbeam@59 140 .TP
garbeam@59 141 .B Mod1-Button3
garbeam@59 142 Resizes current
garbeam@59 143 .B window
garbeam@59 144 while dragging
garbeam@79 145 .SH BUGS
garbeam@79 146 Some terminal programs do not behave correctly in tiled mode, because
garbeam@79 147 incremental resizals are ignored to use maximum screen real estate. You can
garbeam@79 148 patch the code to fix this.