| 1 | .TH evilwm 1 "February 13, 2006" "" "" |
|---|
| 2 | .SH NAME |
|---|
| 3 | evilwm \- Minimalist Window Manager for X |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | .B evilwm [ \-display |
|---|
| 6 | .I display |
|---|
| 7 | .B ] [ \-term |
|---|
| 8 | .I termprog |
|---|
| 9 | .B ] [ \-fn |
|---|
| 10 | .I fontname |
|---|
| 11 | .B ] [ \-fg |
|---|
| 12 | .I foreground colour |
|---|
| 13 | .B ] [ \-fc |
|---|
| 14 | .I fixed colour |
|---|
| 15 | .B ] [ \-bg |
|---|
| 16 | .I background colour |
|---|
| 17 | .B ] [ \-bw |
|---|
| 18 | .I borderwidth |
|---|
| 19 | .B ] [ \-snap |
|---|
| 20 | .I num |
|---|
| 21 | .B ] [ \-mask1 |
|---|
| 22 | .I modifiers |
|---|
| 23 | .B ] [ \-mask2 |
|---|
| 24 | .I modifiers |
|---|
| 25 | .B ] [ \-altmask |
|---|
| 26 | .I modifier |
|---|
| 27 | .B ] [ [ \-app |
|---|
| 28 | .I name/class |
|---|
| 29 | .B [ \-g |
|---|
| 30 | .I geometry |
|---|
| 31 | .B ] [ \-v |
|---|
| 32 | .I vdesk |
|---|
| 33 | .B ] [ \-s ] ]... |
|---|
| 34 | .B [ \-nosoliddrag ] |
|---|
| 35 | .B [ \-V ] |
|---|
| 36 | .SH DESCRIPTION |
|---|
| 37 | .B evilwm |
|---|
| 38 | is a minimalist window manager based on aewm, extended to feature |
|---|
| 39 | many keyboard controls, and otherwise altered to be more friendly. |
|---|
| 40 | .PP |
|---|
| 41 | In |
|---|
| 42 | .BR evilwm , |
|---|
| 43 | the focus follows the mouse pointer, and focus is not lost if |
|---|
| 44 | you stray onto the root window. The current window border is shaded |
|---|
| 45 | gold, with other windows left as a dark grey. |
|---|
| 46 | .PP |
|---|
| 47 | You can use the mouse to manipulate windows either by click/dragging |
|---|
| 48 | the 1 pixel border, or by holding down Alt and doing so anywhere in the |
|---|
| 49 | client window. The controls are: |
|---|
| 50 | .IP "Button 1" |
|---|
| 51 | Move window. |
|---|
| 52 | .IP "Button 2" |
|---|
| 53 | Resize window. |
|---|
| 54 | .IP "Button 3" |
|---|
| 55 | Lower window. |
|---|
| 56 | .PP |
|---|
| 57 | Most keyboard controls are used by holding down Control and Alt, then |
|---|
| 58 | pressing a key. Available functions are: |
|---|
| 59 | .IP Return |
|---|
| 60 | Spawn new terminal. |
|---|
| 61 | .IP Escape |
|---|
| 62 | Delete current window. Hold Shift as well to force kill a client. |
|---|
| 63 | .IP Insert |
|---|
| 64 | Lower current window. |
|---|
| 65 | .IP "H, J, K, L" |
|---|
| 66 | Move window left, down, up or right (16 pixels). Holding Shift resizes the |
|---|
| 67 | window instead. |
|---|
| 68 | .IP "Y, U, B, N" |
|---|
| 69 | Move window to top-left, top-right, bottom-left or |
|---|
| 70 | bottom-right of screen. |
|---|
| 71 | .IP I |
|---|
| 72 | Show information about current window. |
|---|
| 73 | .IP Equals |
|---|
| 74 | Maximise current window vertically (toggle). |
|---|
| 75 | .IP X |
|---|
| 76 | Maximise current window (toggle). |
|---|
| 77 | .PP |
|---|
| 78 | If compiled with virtual desktop support, these functions are also available: |
|---|
| 79 | .IP F |
|---|
| 80 | Fix or unfix current window. |
|---|
| 81 | .IP "1--8" |
|---|
| 82 | Switch virtual desktop. |
|---|
| 83 | .IP Left |
|---|
| 84 | Previous virtual desktop. |
|---|
| 85 | .IP Right |
|---|
| 86 | Next virtual desktop. |
|---|
| 87 | .PP |
|---|
| 88 | In addition to the above, Alt+Tab can be used to cycle through windows |
|---|
| 89 | on screen. |
|---|
| 90 | .PP |
|---|
| 91 | To make |
|---|
| 92 | .B evilwm |
|---|
| 93 | exit, you have to kill the process. |
|---|
| 94 | .SH OPTIONS |
|---|
| 95 | .IP "\-display display" |
|---|
| 96 | specifies the X display to run on. |
|---|
| 97 | .IP "\-term termprog" |
|---|
| 98 | specifies an alternative program to run when spawning a new terminal (defaults |
|---|
| 99 | to xterm, or x\-terminal\-emulator in Debian). |
|---|
| 100 | .IP "\-fn fontname" |
|---|
| 101 | specify a font to use when resizing or displaying window titles. |
|---|
| 102 | .IP "\-fg foreground colour" |
|---|
| 103 | frame colour of currently active window. |
|---|
| 104 | .IP "\-fc fixed colour" |
|---|
| 105 | frame colour of active fixed windows. |
|---|
| 106 | .IP "\-bg background colour" |
|---|
| 107 | frame colour of inactive windows. |
|---|
| 108 | .IP "\-bw borderwidth" |
|---|
| 109 | width of window borders in pixels. |
|---|
| 110 | .IP "\-snap num" |
|---|
| 111 | enable snap-to-border support. num gives the proximity in pixels to snap to. |
|---|
| 112 | .IP "\-mask1 modifiers" |
|---|
| 113 | .IP "\-mask2 modifiers" |
|---|
| 114 | .IP "\-altmask modifier" |
|---|
| 115 | override the default keyboard modifiers used to grab keys for window manager |
|---|
| 116 | functionality. |
|---|
| 117 | .I mask1 |
|---|
| 118 | is used for most keyboard controls (default: control+alt), and |
|---|
| 119 | .I mask2 |
|---|
| 120 | is used for mouse button controls and cycling windows (default: alt). |
|---|
| 121 | .I altmask |
|---|
| 122 | is used to modify the behaviour of certain controls (default: shift). |
|---|
| 123 | Modifiers may be separated with + signs. Valid modifiers are shift, lock, |
|---|
| 124 | control, alt, mod1, mod2, mod3, mod4, mod5. |
|---|
| 125 | .IP "\-app name/class" |
|---|
| 126 | match an application by instance name and class (for help in finding these, |
|---|
| 127 | use the |
|---|
| 128 | .BR xprop |
|---|
| 129 | tool to extract the |
|---|
| 130 | .I WM_CLASS |
|---|
| 131 | property). Subsequent |
|---|
| 132 | .I \-g, \-s |
|---|
| 133 | and |
|---|
| 134 | .I \-v |
|---|
| 135 | options will apply to this match. |
|---|
| 136 | .IP "\-g geometry" |
|---|
| 137 | apply a geometry (using a standard X geometry string) to applications matching |
|---|
| 138 | the last |
|---|
| 139 | .I \-app. |
|---|
| 140 | .IP "\-v vdesk" |
|---|
| 141 | specify a default virtual desktop for applications matching the last |
|---|
| 142 | .I \-app. |
|---|
| 143 | Note that desktops are numbered from 0. |
|---|
| 144 | .IP "\-s" |
|---|
| 145 | specify that application is to start with a sticky client window. |
|---|
| 146 | .IP "\-nosoliddrag" |
|---|
| 147 | draw a window outline while moving or resizing. |
|---|
| 148 | .IP "\-V" |
|---|
| 149 | print version number. |
|---|
| 150 | .SH BUGS |
|---|
| 151 | The author's idea of friendly may differ to that of many other people. |
|---|
| 152 | .SH AUTHOR |
|---|
| 153 | Ciaran Anscomb <evilwm@6809.org.uk>. |
|---|
| 154 | .br |
|---|
| 155 | aewm was written by Decklin Foster <fosterd@hartwick.edu>. |
|---|
| 156 | .br |
|---|
| 157 | 9wm was written by David Hogan <dhog@cs.su.oz.au>. |
|---|
| 158 | .SH "SEE ALSO" |
|---|
| 159 | .BR xterm (1), |
|---|
| 160 | .BR xprop (1) |
|---|
