aewl

annotate aewl.1 @ 787:eecb13b34511

Put floating windows on random starting positions
author markus schnalke <meillo@marmaro.de>
date Fri, 18 Oct 2024 23:42:20 +0200
parents 45f23169563e
children
rev   line source
meillo@775 1 .TH AEWL 1 aewl-0.2
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@775 14 This man page is the one from dwm-3.4 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
meillo@775 48 .SS Standard input
arg@256 49 .TP
meillo@775 50 Standard input is read and displayed in the status text area.
meillo@759 51
arg@256 52 .SS Keyboard commands
garbeam@55 53 .TP
arg@293 54 .B Mod1-Shift-Return
meillo@775 55 Start a terminal emulator.
arg@293 56 .TP
arg@293 57 .B Mod1-Tab
arg@445 58 Focus next window.
arg@293 59 .TP
meillo@775 60 .BR Mod1-F1 " / " Mod1-F2
meillo@775 61 Change view (tagged/untagged).
arg@293 62 .TP
meillo@759 63 .B Mod1-F3
meillo@775 64 Move current window to other view.
arg@594 65 .TP
meillo@775 66 .B Mod1-asciicircum
meillo@759 67 Start
meillo@759 68 .BR dmenu (1)
arg@293 69 .TP
meillo@759 70 .B Mod1-1
meillo@775 71 Move current window to/from master area (tiling mode), toggle maximization current window (floating mode).
meillo@759 72 .TP
meillo@759 73 .B Mod1-2
arg@445 74 Close focused window.
garbeam@55 75 .TP
meillo@775 76 .BR Mod1-plus " or " Mod1-minus
meillo@775 77 Increase/decrease the number of windows in the master area (tiling mode only).
meillo@775 78 .TP
garbeam@55 79 .B Mod1-space
meillo@775 80 Toggle between tiling and max mode.
garbeam@56 81 .TP
arg@585 82 .B Mod1-Shift-space
meillo@759 83 Toggle focused window between floating and non-floating state.
arg@264 84 .TP
arg@293 85 .B Mod1-Shift-q
meillo@775 86 Quit window manager.
meillo@759 87
arg@256 88 .SS Mouse commands
garbeam@82 89 .TP
garbeam@59 90 .B Mod1-Button1
arg@445 91 Move current window while dragging (floating mode only).
garbeam@59 92 .TP
garbeam@59 93 .B Mod1-Button3
arg@445 94 Resize current window while dragging (floating mode only).
meillo@759 95
meillo@759 96
garbeam@82 97 .SH CUSTOMIZATION
arg@445 98 dwm is customized by creating a custom config.h and (re)compiling the source
arg@174 99 code. This keeps it fast, secure and simple.
meillo@759 100
meillo@759 101
arg@724 102 .SH SEE ALSO
arg@724 103 .BR dmenu (1)
meillo@759 104
meillo@759 105
arg@723 106 .SH BUGS
arg@347 107 The status bar may display
arg@633 108 .BR "EOF"
arg@632 109 when dwm has been started by an X session manager like
arg@264 110 .BR xdm (1),
arg@632 111 because those close standard output before executing dwm.
arg@632 112 .P
arg@632 113 Java applications which use the XToolkit/XAWT backend may draw grey windows
arg@632 114 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
arg@634 115 JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
arg@634 116 you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
arg@634 117 can set the following environment variable (to use the older Motif
arg@632 118 backend instead):
arg@632 119 .BR AWT_TOOLKIT=MToolkit .