3 ba19f6b5 2004-04-19 devnull rio \- rio-like Window Manager for X
4 ba19f6b5 2004-04-19 devnull .SH SYNOPSIS
8 058b0118 2005-01-03 devnull .I fontname
11 058b0118 2005-01-03 devnull .B \-grey
17 ba19f6b5 2004-04-19 devnull .B \-term
18 ba19f6b5 2004-04-19 devnull .I termprog
21 058b0118 2005-01-03 devnull .B \-version
24 058b0118 2005-01-03 devnull .B \-virtuals
30 058b0118 2005-01-03 devnull .B restart
32 ba19f6b5 2004-04-19 devnull .SH DESCRIPTION
33 058b0118 2005-01-03 devnull .if t .ds 85 8\(12
34 058b0118 2005-01-03 devnull .if n .ds 85 8-1/2
36 ba19f6b5 2004-04-19 devnull is a window manager for X which attempts to emulate the window management
37 ba19f6b5 2004-04-19 devnull policies of Plan 9's
39 ba19f6b5 2004-04-19 devnull window manager.
40 6a0171e9 2005-01-14 devnull Rio is derived from David Hogan's 9wm.
43 ba19f6b5 2004-04-19 devnull .B \-grey
44 058b0118 2005-01-03 devnull option makes the background stippled grey, the default X11 background,
45 058b0118 2005-01-03 devnull instead of solid grey, the Plan 9 background.
48 ba19f6b5 2004-04-19 devnull .B \-font
50 ba19f6b5 2004-04-19 devnull sets the font in
51 ba19f6b5 2004-04-19 devnull .IR rio 's
53 ba19f6b5 2004-04-19 devnull .IR fname ,
54 ba19f6b5 2004-04-19 devnull overriding the default.
55 058b0118 2005-01-03 devnull Unlike the other programs in the Plan 9 ports, rio expects this
56 058b0118 2005-01-03 devnull font to be an X11 font rather than a Plan 9 font.
59 ba19f6b5 2004-04-19 devnull .B \-term
61 ba19f6b5 2004-04-19 devnull specifies an alternative program to run when the
63 ba19f6b5 2004-04-19 devnull menu item is selected.
64 058b0118 2005-01-03 devnull The default is to try
65 058b0118 2005-01-03 devnull .IR 9term (1)
66 058b0118 2005-01-03 devnull and then to fall back to
67 058b0118 2005-01-03 devnull .IR xterm (1).
70 058b0118 2005-01-03 devnull option causes
75 058b0118 2005-01-03 devnull .IR 9term 's
76 058b0118 2005-01-03 devnull command-line, starting the window in scrolling mode.
79 ba19f6b5 2004-04-19 devnull .B \-version
81 ba19f6b5 2004-04-19 devnull prints the current version on standard error, then exits.
84 058b0118 2005-01-03 devnull .B \-virtuals
85 058b0118 2005-01-03 devnull option sets the number of virtual screens (the default is 1,
86 058b0118 2005-01-03 devnull and the maximum is 12).
88 058b0118 2005-01-03 devnull If the argument
91 058b0118 2005-01-03 devnull .B restart
92 058b0118 2005-01-03 devnull is given,
93 058b0118 2005-01-03 devnull it is sent to an already-running
94 058b0118 2005-01-03 devnull .IR rio ,
95 058b0118 2005-01-03 devnull causing the extant
97 058b0118 2005-01-03 devnull to exit or restart.
98 058b0118 2005-01-03 devnull .SS Using rio
100 ba19f6b5 2004-04-19 devnull One window is
101 ba19f6b5 2004-04-19 devnull .IR current ,
102 ba19f6b5 2004-04-19 devnull and is indicated with a dark border and text;
103 ba19f6b5 2004-04-19 devnull characters typed on the keyboard are available in the
104 ba19f6b5 2004-04-19 devnull .B /dev/cons
105 ba19f6b5 2004-04-19 devnull file of the process in the current window.
106 ba19f6b5 2004-04-19 devnull Characters written on
107 ba19f6b5 2004-04-19 devnull .B /dev/cons
108 ba19f6b5 2004-04-19 devnull appear asynchronously in the associated window whether or not the window
109 ba19f6b5 2004-04-19 devnull is current.
111 ba19f6b5 2004-04-19 devnull Windows are created, deleted and rearranged using the mouse.
112 ba19f6b5 2004-04-19 devnull Clicking (pressing and releasing) mouse button 1 in a non-current
113 ba19f6b5 2004-04-19 devnull window makes that window current and brings it in front of
114 ba19f6b5 2004-04-19 devnull any windows that happen to be overlapping it.
115 ba19f6b5 2004-04-19 devnull When the mouse cursor points to the background area or is in
116 ba19f6b5 2004-04-19 devnull a window that has not claimed the mouse for its own use,
117 ba19f6b5 2004-04-19 devnull pressing mouse button 3 activates a
118 ba19f6b5 2004-04-19 devnull menu of window operations provided by
119 ba19f6b5 2004-04-19 devnull .IR rio .
120 ba19f6b5 2004-04-19 devnull Releasing button 3 then selects an operation.
121 ba19f6b5 2004-04-19 devnull At this point, a gunsight or cross cursor indicates that
122 ba19f6b5 2004-04-19 devnull an operation is pending.
123 ba19f6b5 2004-04-19 devnull The button 3 menu operations are:
124 ba19f6b5 2004-04-19 devnull .TF Resize
127 ba19f6b5 2004-04-19 devnull Create a window.
128 ba19f6b5 2004-04-19 devnull Press button 3 where one corner of the new rectangle should
129 ba19f6b5 2004-04-19 devnull appear (cross cursor), and move the mouse, while holding down button 3, to the
130 ba19f6b5 2004-04-19 devnull diagonally opposite corner.
131 ba19f6b5 2004-04-19 devnull Releasing button 3 creates the window, and makes it current.
132 ba19f6b5 2004-04-19 devnull Very small windows may not be created.
133 ba19f6b5 2004-04-19 devnull The new window is created running
134 ba19f6b5 2004-04-19 devnull .IR termprog ,
135 ba19f6b5 2004-04-19 devnull by default
136 ba19f6b5 2004-04-19 devnull .IR 9term (1)
138 ba19f6b5 2004-04-19 devnull .I 9term
139 ba19f6b5 2004-04-19 devnull is not available,
140 ba19f6b5 2004-04-19 devnull .IR xterm (1).
142 ba19f6b5 2004-04-19 devnull .B Resize
143 ba19f6b5 2004-04-19 devnull Change the size and location of a window.
144 ba19f6b5 2004-04-19 devnull First click button 3 in the window to be changed
145 ba19f6b5 2004-04-19 devnull (gunsight cursor).
146 ba19f6b5 2004-04-19 devnull Then sweep out a window as for the
148 ba19f6b5 2004-04-19 devnull operation.
149 ba19f6b5 2004-04-19 devnull The window is made current.
152 ba19f6b5 2004-04-19 devnull Move a window to another location.
153 ba19f6b5 2004-04-19 devnull After pressing and holding button 3 over the window to be moved (gunsight cursor),
154 ba19f6b5 2004-04-19 devnull indicate the new position by dragging the rectangle to the new location.
155 ba19f6b5 2004-04-19 devnull The window is made current.
156 ba19f6b5 2004-04-19 devnull Windows may be moved partially off-screen.
158 ba19f6b5 2004-04-19 devnull .B Delete
159 ba19f6b5 2004-04-19 devnull Delete a window. Click in the window to be deleted (gunsight cursor).
160 ba19f6b5 2004-04-19 devnull Deleting a window causes a
161 ba19f6b5 2004-04-19 devnull .L hangup
162 ba19f6b5 2004-04-19 devnull note to be sent to all processes in the window's process group
164 ba19f6b5 2004-04-19 devnull .IR notify (3)).
167 ba19f6b5 2004-04-19 devnull Hide a window. Click in the window to be hidden (gunsight cursor);
168 ba19f6b5 2004-04-19 devnull it will be moved off-screen.
169 ba19f6b5 2004-04-19 devnull Each hidden window is given a menu entry in the button 3 menu
170 ba19f6b5 2004-04-19 devnull according to its current window system label.
172 ba19f6b5 2004-04-19 devnull .I label
173 ba19f6b5 2004-04-19 devnull Restore a hidden window.
176 ba19f6b5 2004-04-19 devnull Windows may also be arranged by dragging their borders.
177 ba19f6b5 2004-04-19 devnull Pressing button 1 or 2 over a window's border allows one to
178 ba19f6b5 2004-04-19 devnull move the corresponding edge or corner, while button 3
179 ba19f6b5 2004-04-19 devnull moves the whole window.
181 058b0118 2005-01-03 devnull When the mouse cursor points to the background area
184 058b0118 2005-01-03 devnull has been started with multiple virtual screens using the
185 058b0118 2005-01-03 devnull .B \-virtuals
187 058b0118 2005-01-03 devnull clicking button 2 brings up a menu to select a virtual screen to view.
188 058b0118 2005-01-03 devnull Scrolling the mouse wheel while the cursor points at the background
189 058b0118 2005-01-03 devnull will cycle through the virtual screens.
190 ba19f6b5 2004-04-19 devnull .SH BUGS
192 ba19f6b5 2004-04-19 devnull Plan 9's
193 ba19f6b5 2004-04-19 devnull .IR rio ,
194 ba19f6b5 2004-04-19 devnull clicking button 2 or button 3 to select a window also sends that
195 ba19f6b5 2004-04-19 devnull event to the window itself. This
197 ba19f6b5 2004-04-19 devnull does not.
199 ba19f6b5 2004-04-19 devnull The command-line syntax is non-standard.
201 ba19f6b5 2004-04-19 devnull In Plan 9's
202 ba19f6b5 2004-04-19 devnull .IR rio ,
203 ba19f6b5 2004-04-19 devnull newly started applications take over the current window.
206 ba19f6b5 2004-04-19 devnull starts a new window for each program.
207 ba19f6b5 2004-04-19 devnull (In X11, it appears to be impossible to know which window
208 ba19f6b5 2004-04-19 devnull starts a particular program.)
210 ba19f6b5 2004-04-19 devnull There is a currently a compiled-in limit of 128 hidden windows.
211 ba19f6b5 2004-04-19 devnull .SH "SEE ALSO"
212 ba19f6b5 2004-04-19 devnull .IR 9term (1),
213 058b0118 2005-01-03 devnull .IR xterm (1)
215 6a0171e9 2005-01-14 devnull As mentioned above,
217 6a0171e9 2005-01-14 devnull is mainly maintenance updates
218 6a0171e9 2005-01-14 devnull applied to the original
220 6a0171e9 2005-01-14 devnull by David Hogan; see
221 6a0171e9 2005-01-14 devnull .HR http://unauthorised.org/dhog/9wm.html "" .