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