aewl

annotate aewl.1 @ 769:49aa8ccceefa

find changesets by author, revision, files, or words in the commit message
cleanups in domax and more
author meillo@marmaro.de
date Fri, 05 Dec 2008 21:42:47 +0100
parents 583c0adeee79
children 794a83e74023
rev   line source
meillo@759 1 .TH AEWL 1 aewl-VERSION
meillo@759 2
meillo@759 3
garbeam@0 4 .SH NAME
meillo@759 5 aewl \- a fork of dwm, the dynamic window manager
meillo@759 6
meillo@759 7
garbeam@0 8 .SH SYNOPSIS
meillo@759 9 .B aewl
garbeam@0 10 .RB [ \-v ]
meillo@759 11
meillo@759 12
garbeam@0 13 .SH DESCRIPTION
meillo@759 14 This man page is the one from dwm 4.4.1 on which aewl is based.
meillo@759 15 It is partly updated, but not totally.
meillo@759 16 .P
arg@445 17 dwm is a dynamic window manager for X. It manages windows in tiling and
arg@445 18 floating modes. Either mode can be applied dynamically, optimizing the
arg@445 19 environment for the application in use and the task performed.
garbeam@79 20 .P
arg@504 21 In tiling mode windows are managed in a master and stacking area. The master
arg@657 22 area contains the windows which currently need most attention, whereas the
arg@504 23 stacking area contains all other windows. In floating mode windows can be
arg@174 24 resized and moved freely. Dialog windows are always managed floating,
arg@667 25 regardless of the mode applied.
garbeam@80 26 .P
arg@174 27 Windows are grouped by tags. Each window can be tagged with one or multiple
arg@470 28 tags. Selecting certain tags displays all windows with these tags.
garbeam@79 29 .P
arg@445 30 dwm contains a small status bar which displays all available tags, the mode,
arg@445 31 the title of the focused window, and the text read from standard input. The
arg@575 32 selected tags are indicated with a different color. The tags of the focused
arg@606 33 window are indicated with a filled square in the top left corner. The tags
arg@625 34 which are applied to one or more windows are indicated with an empty square in
arg@606 35 the top left corner.
arg@316 36 .P
arg@700 37 dwm draws a small border around windows to indicate the focus state.
meillo@759 38
meillo@759 39
garbeam@80 40 .SH OPTIONS
garbeam@0 41 .TP
garbeam@0 42 .B \-v
garbeam@80 43 prints version information to standard output, then exits.
meillo@759 44
meillo@759 45
garbeam@82 46 .SH USAGE
meillo@759 47
arg@256 48 .SS Status bar
arg@256 49 .TP
arg@259 50 .B Standard input
arg@259 51 is read and displayed in the status text area.
arg@256 52 .TP
arg@288 53 .B Button1
meillo@759 54 click on the bar to display the other tag.
meillo@759 55
arg@256 56 .SS Keyboard commands
garbeam@55 57 .TP
arg@293 58 .B Mod1-Shift-Return
arg@293 59 Start
arg@293 60 .BR xterm (1).
arg@293 61 .TP
arg@293 62 .B Mod1-Tab
arg@445 63 Focus next window.
arg@293 64 .TP
arg@655 65 .B Mod1-i
arg@668 66 Increase the number of windows in the master area (tiling mode only).
arg@651 67 .TP
arg@655 68 .B Mod1-d
arg@668 69 Decrease the number of windows in the master area (tiling mode only).
arg@651 70 .TP
meillo@759 71 .B Mod1-F1
meillo@759 72 View other tag.
arg@293 73 .TP
meillo@759 74 .B Mod1-F3
meillo@759 75 Move current window to other tag.
arg@594 76 .TP
meillo@759 77 .B Mod1-^
meillo@759 78 Start
meillo@759 79 .BR dmenu (1)
arg@293 80 .TP
meillo@759 81 .B Mod1-1
meillo@759 82 Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode).
meillo@759 83 .TP
meillo@759 84 .B Mod1-2
arg@445 85 Close focused window.
garbeam@55 86 .TP
garbeam@55 87 .B Mod1-space
meillo@759 88 Toggle between tiling and max mode (affects all windows).
garbeam@56 89 .TP
arg@585 90 .B Mod1-Shift-space
meillo@759 91 Toggle focused window between floating and non-floating state.
arg@264 92 .TP
arg@293 93 .B Mod1-Shift-q
arg@445 94 Quit dwm.
meillo@759 95
arg@256 96 .SS Mouse commands
garbeam@82 97 .TP
garbeam@59 98 .B Mod1-Button1
arg@445 99 Move current window while dragging (floating mode only).
garbeam@59 100 .TP
garbeam@59 101 .B Mod1-Button3
arg@445 102 Resize current window while dragging (floating mode only).
meillo@759 103
meillo@759 104
garbeam@82 105 .SH CUSTOMIZATION
arg@445 106 dwm is customized by creating a custom config.h and (re)compiling the source
arg@174 107 code. This keeps it fast, secure and simple.
meillo@759 108
meillo@759 109
arg@724 110 .SH SEE ALSO
arg@724 111 .BR dmenu (1)
meillo@759 112
meillo@759 113
arg@723 114 .SH BUGS
arg@347 115 The status bar may display
arg@633 116 .BR "EOF"
arg@632 117 when dwm has been started by an X session manager like
arg@264 118 .BR xdm (1),
arg@632 119 because those close standard output before executing dwm.
arg@632 120 .P
arg@632 121 Java applications which use the XToolkit/XAWT backend may draw grey windows
arg@632 122 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
arg@634 123 JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
arg@634 124 you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
arg@634 125 can set the following environment variable (to use the older Motif
arg@632 126 backend instead):
arg@632 127 .BR AWT_TOOLKIT=MToolkit .