Mercurial > aewl

annotate aewl.1 @ 771:59a6f0ba5478

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
beautified status bar
author meillo@marmaro.de
date Sat, 06 Dec 2008 10:56:43 +0100
parents 45f23169563e
children 794a83e74023
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
1 .TH AEWL 1 aewl-VERSION
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
2
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
3
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
4 .SH NAME
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
5 aewl \- a fork of dwm, the dynamic window manager
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
6
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
7
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
8 .SH SYNOPSIS
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
9 .B aewl
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
10 .RB [ \-v ]
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
11
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
12
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
13 .SH DESCRIPTION
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
14 This man page is the one from dwm 4.4.1 on which aewl is based.
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
15 It is partly updated, but not totally.
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
16 .P
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
17 dwm is a dynamic window manager for X. It manages windows in tiling and
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
18 floating modes. Either mode can be applied dynamically, optimizing the
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
19 environment for the application in use and the task performed.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
20 .P
504
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
21 In tiling mode windows are managed in a master and stacking area. The master
657
ce3538c5c0d9 removed the term clients from dwm.1
Anselm R. Garbe <arg@suckless.org>
parents: 655
diff changeset
22 area contains the windows which currently need most attention, whereas the
504
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
23 stacking area contains all other windows. In floating mode windows can be
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
24 resized and moved freely. Dialog windows are always managed floating,
667
70f19af50393 changed a term in dwm.1
Anselm R. Garbe <arg@suckless.org>
parents: 657
diff changeset
25 regardless of the mode applied.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
26 .P
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
27 Windows are grouped by tags. Each window can be tagged with one or multiple
470
9d728cba93d6 fixed a nuance in dwm.1
arg@mmvi
parents: 449
diff changeset
28 tags. Selecting certain tags displays all windows with these tags.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
29 .P
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
30 dwm contains a small status bar which displays all available tags, the mode,
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
31 the title of the focused window, and the text read from standard input. The
575
719b37b37b0d using the term 'indicated' instead of 'higlighted'
arg@mig29
parents: 574
diff changeset
32 selected tags are indicated with a different color. The tags of the focused
606
44b5617c78b3 and the winner is
arg@mig29
parents: 602
diff changeset
33 window are indicated with a filled square in the top left corner. The tags
625
0811e4114faa we don't use the term clients anymore, windows is the better term
arg@mig29
parents: 606
diff changeset
34 which are applied to one or more windows are indicated with an empty square in
606
44b5617c78b3 and the winner is
arg@mig29
parents: 602
diff changeset
35 the top left corner.
316
d69cdb180a3e small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents: 293
diff changeset
36 .P
700
f05c825db96b moved BORDERPX to config.*.h
Anselm R. Garbe <arg@suckless.org>
parents: 687
diff changeset
37 dwm draws a small border around windows to indicate the focus state.
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
38
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
39
80
8125f908c80c several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents: 79
diff changeset
40 .SH OPTIONS
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
41 .TP
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
42 .B \-v
80
8125f908c80c several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents: 79
diff changeset
43 prints version information to standard output, then exits.
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
44
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
45
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
46 .SH USAGE
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
47
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
48 .SS Status bar
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
49 .TP
259
d661ecce0c75 applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents: 258
diff changeset
50 .B Standard input
d661ecce0c75 applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents: 258
diff changeset
51 is read and displayed in the status text area.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
52 .TP
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
53 .B Button1
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
54 click on the bar to display the other tag.
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
55
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
56 .SS Keyboard commands
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
57 .TP
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
58 .B Mod1-Shift-Return
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
59 Start
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
60 .BR xterm (1).
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
61 .TP
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
62 .B Mod1-Tab
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
63 Focus next window.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
64 .TP
655
4cf9ab28b36c changed shortcuts to M-i and M-d
Anselm R. Garbe <arg@suckless.org>
parents: 653
diff changeset
65 .B Mod1-i
668
93ebb497c60d small grammar fix of dwm.1
Anselm R. Garbe <arg@suckless.org>
parents: 667
diff changeset
66 Increase the number of windows in the master area (tiling mode only).
651
b9f4efd21473 added MODKEY-{plus,minus} shortcuts (increasing/decreasing master clients)
Anselm R. Garbe <arg@suckless.org>
parents: 634
diff changeset
67 .TP
655
4cf9ab28b36c changed shortcuts to M-i and M-d
Anselm R. Garbe <arg@suckless.org>
parents: 653
diff changeset
68 .B Mod1-d
668
93ebb497c60d small grammar fix of dwm.1
Anselm R. Garbe <arg@suckless.org>
parents: 667
diff changeset
69 Decrease the number of windows in the master area (tiling mode only).
651
b9f4efd21473 added MODKEY-{plus,minus} shortcuts (increasing/decreasing master clients)
Anselm R. Garbe <arg@suckless.org>
parents: 634
diff changeset
70 .TP
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
71 .B Mod1-F1
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
72 View other tag.
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
73 .TP
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
74 .B Mod1-F3
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
75 Move current window to other tag.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
76 .TP
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
77 .B Mod1-^
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
78 Start
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
79 .BR dmenu (1)
594
f7dcd3ac8d6f removed viewall(), replaced with view(-1); added tag(-1) to tag a client with all tags (new key combo MODKEY-Shift-0)
arg@mig29
parents: 592
diff changeset
80 .TP
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
81 .B Mod1-1
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
82 Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode).
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
83 .TP
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
84 .B Mod1-2
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
85 Close focused window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
86 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
87 .B Mod1-space
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
88 Toggle between tiling and max mode (affects all windows).
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
89 .TP
585
83807f4d18e9 added man page entry
arg@mig29
parents: 578
diff changeset
90 .B Mod1-Shift-space
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
91 Toggle focused window between floating and non-floating state.
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
92 .TP
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
93 .B Mod1-Shift-q
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
94 Quit dwm.
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
95
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
96 .SS Mouse commands
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
97 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
98 .B Mod1-Button1
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
99 Move current window while dragging (floating mode only).
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
100 .TP
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
101 .B Mod1-Button3
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
102 Resize current window while dragging (floating mode only).
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
103
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
104
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
105 .SH CUSTOMIZATION
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
106 dwm is customized by creating a custom config.h and (re)compiling the source
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 171
diff changeset
107 code. This keeps it fast, secure and simple.
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
108
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
109
724
583c0adeee79 regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents: 723
diff changeset
110 .SH SEE ALSO
583c0adeee79 regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents: 723
diff changeset
111 .BR dmenu (1)
759
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
112
45f23169563e renamed dwm to aewl
meillo@marmaro.de
parents: 724
diff changeset
113
723
251047bc6129 renamed CAVEATS into BUGS
Anselm R. Garbe <arg@suckless.org>
parents: 700
diff changeset
114 .SH BUGS
347
e438c8ba86f6 yet another fix
Anselm R. Garbe <arg@10kloc.org>
parents: 346
diff changeset
115 The status bar may display
633
7209e355762c fixed man page, status bar displays EOF instead of "broken pipe"
arg@mig29
parents: 632
diff changeset
116 .BR "EOF"
632
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
117 when dwm has been started by an X session manager like
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
118 .BR xdm (1),
632
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
119 because those close standard output before executing dwm.
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
120 .P
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
121 Java applications which use the XToolkit/XAWT backend may draw grey windows
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
122 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
634
21951c0dfbae applied Sanders patch
arg@mig29
parents: 633
diff changeset
123 JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
21951c0dfbae applied Sanders patch
arg@mig29
parents: 633
diff changeset
124 you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
21951c0dfbae applied Sanders patch
arg@mig29
parents: 633
diff changeset
125 can set the following environment variable (to use the older Motif
632
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
126 backend instead):
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
127 .BR AWT_TOOLKIT=MToolkit .