1 .if t .ds 85 8\(12
2 .if n .ds 85 8-1/2
3 .TH 9wm 1
4 .SH NAME
5 9wm \- \*(85-like Window Manager for X
6 .SH SYNOPSIS
7 .B 9wm
8 [
9 .B \-grey
10 ] [
11 .B \-version
12 ] [
13 .B \-font
14 .I fname
15 ] [
16 .B \-term
17 .I termprog
18 ] [
19 .BR exit | restart
20 ]
21 .SH DESCRIPTION
22 .I 9wm
23 is a window manager for X which attempts to emulate the window management
24 policies of Plan 9's 
25 .I \*(85
26 window manager.
27 .PP
28 The
29 .B \-grey
30 option makes the background light grey, as does \*(85.
31 Use this option for maximum authenticity.
32 .B \-font
33 .I fname
34 sets the font in
35 .IR 9wm 's
36 menu to
37 .IR fname ,
38 overriding the default.
39 .B \-term
40 .I termprog
41 specifies an alternative program to run when the
42 .I New
43 menu item is selected.
44 .B \-version
45 prints the current version on standard error, then exits.
46 .PP
47 To make 
48 .I 9wm
49 exit, you have to run
50 .B "9wm exit"
51 on the command line.  There is no ``exit'' menu item.
52 .PP
53 .I 9wm
54 is click-to-type: it has a notion of the current window,
55 which is usually on top, and always has its border darkened.
56 Characters typed at the keyboard go to the current window,
57 and mouse clicks outside the current window are swallowed up
58 by
59 .IR 9wm .
60 To make another window the current one, click on it with button 1.
61 Unlike other X window managers, 9wm implements `mouse focus': mouse events
62 are sent only to the current window.
63 .PP
64 A menu of window operations is available by pressing button 3
65 outside the current window.
66 The first of these,
67 .IR New ,
68 attempts to spawn a
69 .I 9term
70 process (or
71 .I xterm
72 if
73 .I 9term
74 is not available).
75 The new
76 .I 9term
77 will request that its outline be swept using button 3
78 of the mouse, by changing the cursor.
79 .RI ( xterm
80 defaults to a fixed size, and thus wants to be dragged; pressing
81 button 3 places it.)
82 .PP
83 The next four menu items are
84 .IR Reshape ,
85 .IR Move ,
86 .IR Delete ,
87 and
88 .IR Hide .
89 All of the operations change the cursor into a target, prompting the user
90 to click button 3 on one of the windows to select it for the operation.
91 At this stage, clicking button 1 or 2 will abort the operation.
92 Otherwise, if the operation was
93 .IR Resize ,
94 the user is prompted to sweep out the new outline with button 3.
95 If it was
96 .IR Move ,
97 the user should keep the button held down after the initial click that selected
98 the window, and drag the window to the right place before releasing.
99 In either case, button 1 or 2 will abort the operation.
100 .PP
101 If the
102 .I Delete
103 operation is selected, the window will be deleted when the button is released.
104 This typically kills the client that owns the window.
105 The
106 .I Hide
107 operation just makes the window invisible.  While hidden, the window's
108 name appears on the bottom of the button 3 menu.  Selecting that item
109 brings the window back (unhides it).
110 This operation replaces the iconification feature provided by other
111 window managers.
112 .SH BUGS
113 Is not completely compatible with \*(85.
114 .PP
115 There is a currently a compiled-in limit of 32 hidden windows.
116 .SH "SEE ALSO"
117 .IR 9term (1),
118 .IR xterm (1).