annotate dwm.1 @ 0:7024076fa948

initial add
author paulo@localhost
date Sun, 22 Mar 2009 23:26:35 -0700
parents
children
rev   line source
paulo@0 1 .TH DWM 1 dwm-VERSION
paulo@0 2 .SH NAME
paulo@0 3 dwm \- dynamic window manager
paulo@0 4 .SH SYNOPSIS
paulo@0 5 .B dwm
paulo@0 6 .RB [ \-v ]
paulo@0 7 .SH DESCRIPTION
paulo@0 8 dwm is a dynamic window manager for X. It manages windows in tiling and
paulo@0 9 versatile layouts. Either layout can be applied dynamically, optimizing the
paulo@0 10 environment for the application in use and the task performed.
paulo@0 11 .P
paulo@0 12 In tiling layout windows are managed in a master and stacking area. The master
paulo@0 13 area contains the windows which currently need most attention, whereas the
paulo@0 14 stacking area contains all other windows. In versatile layout windows can be
paulo@0 15 resized and moved freely. Dialog windows are always managed versatile,
paulo@0 16 regardless of the layout applied.
paulo@0 17 .P
paulo@0 18 Windows are grouped by tags. Each window can be tagged with one or multiple
paulo@0 19 tags. Selecting certain tags displays all windows with these tags.
paulo@0 20 .P
paulo@0 21 dwm contains a small status bar which displays all available tags, the layout,
paulo@0 22 the title of the focused window, and the text read from standard input. The
paulo@0 23 selected tags are indicated with a different color. The tags of the focused
paulo@0 24 window are indicated with a filled square in the top left corner. The tags
paulo@0 25 which are applied to one or more windows are indicated with an empty square in
paulo@0 26 the top left corner.
paulo@0 27 .P
paulo@0 28 dwm draws a small border around windows to indicate the focus state.
paulo@0 29 .SH OPTIONS
paulo@0 30 .TP
paulo@0 31 .B \-v
paulo@0 32 prints version information to standard output, then exits.
paulo@0 33 .SH USAGE
paulo@0 34 .SS Status bar
paulo@0 35 .TP
paulo@0 36 .B Standard input
paulo@0 37 is read and displayed in the status text area.
paulo@0 38 .TP
paulo@0 39 .B Button1
paulo@0 40 click on a tag label to display all windows with that tag, click on the layout
paulo@0 41 label toggles between tiling and versatile layout.
paulo@0 42 .TP
paulo@0 43 .B Button3
paulo@0 44 click on a tag label adds/removes all windows with that tag to/from the view.
paulo@0 45 .TP
paulo@0 46 .B Button4
paulo@0 47 click on the layout label increases the number of windows in the master area (tiling layout only).
paulo@0 48 .TP
paulo@0 49 .B Button5
paulo@0 50 click on the layout label decreases the number of windows in the master area (tiling layout only).
paulo@0 51 .TP
paulo@0 52 .B Mod1-Button1
paulo@0 53 click on a tag label applies that tag to the focused window.
paulo@0 54 .TP
paulo@0 55 .B Mod1-Button3
paulo@0 56 click on a tag label adds/removes that tag to/from the focused window.
paulo@0 57 .SS Keyboard commands
paulo@0 58 .TP
paulo@0 59 .B Mod1-Shift-Return
paulo@0 60 Start
paulo@0 61 .BR xterm (1).
paulo@0 62 .TP
paulo@0 63 .B Mod1-Tab
paulo@0 64 Focus next window.
paulo@0 65 .TP
paulo@0 66 .B Mod1-Shift-Tab
paulo@0 67 Focus previous window.
paulo@0 68 .TP
paulo@0 69 .B Mod1-Return
paulo@0 70 Zooms/cycles current window to/from master area (tiling layout), toggles maximization of current window (versatile layout).
paulo@0 71 .TP
paulo@0 72 .B Mod1-g
paulo@0 73 Grow master area (tiling layout only).
paulo@0 74 .TP
paulo@0 75 .B Mod1-s
paulo@0 76 Shrink master area (tiling layout only).
paulo@0 77 .TP
paulo@0 78 .B Mod1-i
paulo@0 79 Increase the number of windows in the master area (tiling layout only).
paulo@0 80 .TP
paulo@0 81 .B Mod1-d
paulo@0 82 Decrease the number of windows in the master area (tiling layout only).
paulo@0 83 .TP
paulo@0 84 .B Mod1-Shift-[1..n]
paulo@0 85 Apply
paulo@0 86 .RB nth
paulo@0 87 tag to current window.
paulo@0 88 .TP
paulo@0 89 .B Mod1-Shift-0
paulo@0 90 Apply all tags to current window.
paulo@0 91 .TP
paulo@0 92 .B Mod1-Control-Shift-[1..n]
paulo@0 93 Add/remove
paulo@0 94 .B nth
paulo@0 95 tag to/from current window.
paulo@0 96 .TP
paulo@0 97 .B Mod1-Shift-c
paulo@0 98 Close focused window.
paulo@0 99 .TP
paulo@0 100 .B Mod1-space
paulo@0 101 Toggle between tiling and versatile layout (affects all windows).
paulo@0 102 .TP
paulo@0 103 .B Mod1-Shift-space
paulo@0 104 Toggle focused window between versatile and non-versatile state (tiling layout only).
paulo@0 105 .TP
paulo@0 106 .B Mod1-[1..n]
paulo@0 107 View all windows with
paulo@0 108 .BR nth
paulo@0 109 tag.
paulo@0 110 .TP
paulo@0 111 .B Mod1-0
paulo@0 112 View all windows with any tag.
paulo@0 113 .TP
paulo@0 114 .B Mod1-Control-[1..n]
paulo@0 115 Add/remove all windows with
paulo@0 116 .BR nth
paulo@0 117 tag to/from the view.
paulo@0 118 .TP
paulo@0 119 .B Mod1-Shift-q
paulo@0 120 Quit dwm.
paulo@0 121 .SS Mouse commands
paulo@0 122 .TP
paulo@0 123 .B Mod1-Button1
paulo@0 124 Move current window while dragging (versatile layout only).
paulo@0 125 .TP
paulo@0 126 .B Mod1-Button2
paulo@0 127 Zooms/cycles current window to/from master area (tiling layout), toggles maximization of current window (versatile layout).
paulo@0 128 .TP
paulo@0 129 .B Mod1-Button3
paulo@0 130 Resize current window while dragging (versatile layout only).
paulo@0 131 .SH CUSTOMIZATION
paulo@0 132 dwm is customized by creating a custom config.h and (re)compiling the source
paulo@0 133 code. This keeps it fast, secure and simple.
paulo@0 134 .SH SEE ALSO
paulo@0 135 .BR dmenu (1)
paulo@0 136 .SH BUGS
paulo@0 137 The status bar may display
paulo@0 138 .BR "EOF"
paulo@0 139 when dwm has been started by an X session manager like
paulo@0 140 .BR xdm (1),
paulo@0 141 because those close standard output before executing dwm.
paulo@0 142 .P
paulo@0 143 Java applications which use the XToolkit/XAWT backend may draw grey windows
paulo@0 144 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
paulo@0 145 JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
paulo@0 146 you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
paulo@0 147 can set the following environment variable (to use the older Motif
paulo@0 148 backend instead):
paulo@0 149 .BR AWT_TOOLKIT=MToolkit .