Blame


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
3 038e9089 2004-03-21 devnull .TH 9wm 1
4 038e9089 2004-03-21 devnull .SH NAME
5 038e9089 2004-03-21 devnull 9wm \- \*(85-like Window Manager for X
6 038e9089 2004-03-21 devnull .SH SYNOPSIS
7 038e9089 2004-03-21 devnull .B 9wm
8 038e9089 2004-03-21 devnull [
9 038e9089 2004-03-21 devnull .B \-grey
10 038e9089 2004-03-21 devnull ] [
11 038e9089 2004-03-21 devnull .B \-version
12 038e9089 2004-03-21 devnull ] [
13 038e9089 2004-03-21 devnull .B \-font
14 038e9089 2004-03-21 devnull .I fname
15 038e9089 2004-03-21 devnull ] [
16 038e9089 2004-03-21 devnull .B \-term
17 038e9089 2004-03-21 devnull .I termprog
18 038e9089 2004-03-21 devnull ] [
19 038e9089 2004-03-21 devnull .BR exit | restart
20 038e9089 2004-03-21 devnull ]
21 038e9089 2004-03-21 devnull .SH DESCRIPTION
22 038e9089 2004-03-21 devnull .I 9wm
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
25 038e9089 2004-03-21 devnull .I \*(85
26 038e9089 2004-03-21 devnull window manager.
27 038e9089 2004-03-21 devnull .PP
28 038e9089 2004-03-21 devnull The
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
33 038e9089 2004-03-21 devnull .I fname
34 038e9089 2004-03-21 devnull sets the font in
35 038e9089 2004-03-21 devnull .IR 9wm 's
36 038e9089 2004-03-21 devnull menu to
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
42 038e9089 2004-03-21 devnull .I New
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.
46 038e9089 2004-03-21 devnull .PP
47 038e9089 2004-03-21 devnull To make
48 038e9089 2004-03-21 devnull .I 9wm
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.
52 038e9089 2004-03-21 devnull .PP
53 038e9089 2004-03-21 devnull .I 9wm
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
58 038e9089 2004-03-21 devnull by
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.
63 038e9089 2004-03-21 devnull .PP
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
69 038e9089 2004-03-21 devnull .I 9term
70 038e9089 2004-03-21 devnull process (or
71 038e9089 2004-03-21 devnull .I xterm
72 038e9089 2004-03-21 devnull if
73 038e9089 2004-03-21 devnull .I 9term
74 038e9089 2004-03-21 devnull is not available).
75 038e9089 2004-03-21 devnull The new
76 038e9089 2004-03-21 devnull .I 9term
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.)
82 038e9089 2004-03-21 devnull .PP
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 ,
87 038e9089 2004-03-21 devnull and
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.
100 038e9089 2004-03-21 devnull .PP
101 038e9089 2004-03-21 devnull If the
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.
105 038e9089 2004-03-21 devnull The
106 038e9089 2004-03-21 devnull .I Hide
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.
114 038e9089 2004-03-21 devnull .PP
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).