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
38 ba19f6b5 2004-04-19 devnull .SH DESCRIPTION
39 058b0118 2005-01-03 devnull .if t .ds 85 8\(12
40 058b0118 2005-01-03 devnull .if n .ds 85 8-1/2
42 ba19f6b5 2004-04-19 devnull is a window manager for X which attempts to emulate the window management
43 ba19f6b5 2004-04-19 devnull policies of Plan 9's
45 ba19f6b5 2004-04-19 devnull window manager.
46 6a0171e9 2005-01-14 devnull Rio is derived from David Hogan's 9wm.
49 ba19f6b5 2004-04-19 devnull .B \-grey
50 058b0118 2005-01-03 devnull option makes the background stippled grey, the default X11 background,
51 058b0118 2005-01-03 devnull instead of solid grey, the Plan 9 background.
54 ba19f6b5 2004-04-19 devnull .B \-font
56 ba19f6b5 2004-04-19 devnull sets the font in
57 ba19f6b5 2004-04-19 devnull .IR rio 's
59 ba19f6b5 2004-04-19 devnull .IR fname ,
60 ba19f6b5 2004-04-19 devnull overriding the default.
61 058b0118 2005-01-03 devnull Unlike the other programs in the Plan 9 ports, rio expects this
62 058b0118 2005-01-03 devnull font to be an X11 font rather than a Plan 9 font.
65 ba19f6b5 2004-04-19 devnull .B \-term
67 ba19f6b5 2004-04-19 devnull specifies an alternative program to run when the
69 ba19f6b5 2004-04-19 devnull menu item is selected.
70 058b0118 2005-01-03 devnull The default is to try
71 058b0118 2005-01-03 devnull .IR 9term (1)
72 058b0118 2005-01-03 devnull and then to fall back to
73 058b0118 2005-01-03 devnull .IR xterm (1).
76 058b0118 2005-01-03 devnull option causes
81 058b0118 2005-01-03 devnull .IR 9term 's
82 058b0118 2005-01-03 devnull command-line, starting the window in scrolling mode.
85 ba19f6b5 2004-04-19 devnull .B \-version
87 ba19f6b5 2004-04-19 devnull prints the current version on standard error, then exits.
90 058b0118 2005-01-03 devnull .B \-virtuals
91 058b0118 2005-01-03 devnull option sets the number of virtual screens (the default is 1,
92 058b0118 2005-01-03 devnull and the maximum is 12).
94 058b0118 2005-01-03 devnull If the argument
97 058b0118 2005-01-03 devnull .B restart
98 058b0118 2005-01-03 devnull is given,
99 058b0118 2005-01-03 devnull it is sent to an already-running
100 058b0118 2005-01-03 devnull .IR rio ,
101 058b0118 2005-01-03 devnull causing the extant
103 058b0118 2005-01-03 devnull to exit or restart.
104 058b0118 2005-01-03 devnull .SS Using rio
106 ba19f6b5 2004-04-19 devnull One window is
107 ba19f6b5 2004-04-19 devnull .IR current ,
108 ba19f6b5 2004-04-19 devnull and is indicated with a dark border and text;
109 ba19f6b5 2004-04-19 devnull characters typed on the keyboard are available in the
110 ba19f6b5 2004-04-19 devnull .B /dev/cons
111 ba19f6b5 2004-04-19 devnull file of the process in the current window.
112 ba19f6b5 2004-04-19 devnull Characters written on
113 ba19f6b5 2004-04-19 devnull .B /dev/cons
114 ba19f6b5 2004-04-19 devnull appear asynchronously in the associated window whether or not the window
115 ba19f6b5 2004-04-19 devnull is current.
117 ba19f6b5 2004-04-19 devnull Windows are created, deleted and rearranged using the mouse.
118 ba19f6b5 2004-04-19 devnull Clicking (pressing and releasing) mouse button 1 in a non-current
119 ba19f6b5 2004-04-19 devnull window makes that window current and brings it in front of
120 ba19f6b5 2004-04-19 devnull any windows that happen to be overlapping it.
121 ba19f6b5 2004-04-19 devnull When the mouse cursor points to the background area or is in
122 ba19f6b5 2004-04-19 devnull a window that has not claimed the mouse for its own use,
123 ba19f6b5 2004-04-19 devnull pressing mouse button 3 activates a
124 ba19f6b5 2004-04-19 devnull menu of window operations provided by
125 ba19f6b5 2004-04-19 devnull .IR rio .
126 ba19f6b5 2004-04-19 devnull Releasing button 3 then selects an operation.
127 ba19f6b5 2004-04-19 devnull At this point, a gunsight or cross cursor indicates that
128 ba19f6b5 2004-04-19 devnull an operation is pending.
129 ba19f6b5 2004-04-19 devnull The button 3 menu operations are:
130 ba19f6b5 2004-04-19 devnull .TF Resize
133 ba19f6b5 2004-04-19 devnull Create a window.
134 ba19f6b5 2004-04-19 devnull Press button 3 where one corner of the new rectangle should
135 ba19f6b5 2004-04-19 devnull appear (cross cursor), and move the mouse, while holding down button 3, to the
136 ba19f6b5 2004-04-19 devnull diagonally opposite corner.
137 ba19f6b5 2004-04-19 devnull Releasing button 3 creates the window, and makes it current.
138 ba19f6b5 2004-04-19 devnull Very small windows may not be created.
139 ba19f6b5 2004-04-19 devnull The new window is created running
140 ba19f6b5 2004-04-19 devnull .IR termprog ,
141 ba19f6b5 2004-04-19 devnull by default
142 ba19f6b5 2004-04-19 devnull .IR 9term (1)
144 ba19f6b5 2004-04-19 devnull .I 9term
145 ba19f6b5 2004-04-19 devnull is not available,
146 ba19f6b5 2004-04-19 devnull .IR xterm (1).
148 ba19f6b5 2004-04-19 devnull .B Resize
149 ba19f6b5 2004-04-19 devnull Change the size and location of a window.
150 ba19f6b5 2004-04-19 devnull First click button 3 in the window to be changed
151 ba19f6b5 2004-04-19 devnull (gunsight cursor).
152 ba19f6b5 2004-04-19 devnull Then sweep out a window as for the
154 ba19f6b5 2004-04-19 devnull operation.
155 ba19f6b5 2004-04-19 devnull The window is made current.
158 ba19f6b5 2004-04-19 devnull Move a window to another location.
159 ba19f6b5 2004-04-19 devnull After pressing and holding button 3 over the window to be moved (gunsight cursor),
160 ba19f6b5 2004-04-19 devnull indicate the new position by dragging the rectangle to the new location.
161 ba19f6b5 2004-04-19 devnull The window is made current.
162 ba19f6b5 2004-04-19 devnull Windows may be moved partially off-screen.
164 ba19f6b5 2004-04-19 devnull .B Delete
165 ba19f6b5 2004-04-19 devnull Delete a window. Click in the window to be deleted (gunsight cursor).
166 ba19f6b5 2004-04-19 devnull Deleting a window causes a
167 ba19f6b5 2004-04-19 devnull .L hangup
168 ba19f6b5 2004-04-19 devnull note to be sent to all processes in the window's process group
170 ba19f6b5 2004-04-19 devnull .IR notify (3)).
173 ba19f6b5 2004-04-19 devnull Hide a window. Click in the window to be hidden (gunsight cursor);
174 ba19f6b5 2004-04-19 devnull it will be moved off-screen.
175 ba19f6b5 2004-04-19 devnull Each hidden window is given a menu entry in the button 3 menu
176 ba19f6b5 2004-04-19 devnull according to its current window system label.
178 ba19f6b5 2004-04-19 devnull .I label
179 ba19f6b5 2004-04-19 devnull Restore a hidden window.
182 ba19f6b5 2004-04-19 devnull Windows may also be arranged by dragging their borders.
183 ba19f6b5 2004-04-19 devnull Pressing button 1 or 2 over a window's border allows one to
184 ba19f6b5 2004-04-19 devnull move the corresponding edge or corner, while button 3
185 ba19f6b5 2004-04-19 devnull moves the whole window.
187 058b0118 2005-01-03 devnull When the mouse cursor points to the background area
190 058b0118 2005-01-03 devnull has been started with multiple virtual screens using the
191 058b0118 2005-01-03 devnull .B \-virtuals
193 058b0118 2005-01-03 devnull clicking button 2 brings up a menu to select a virtual screen to view.
194 058b0118 2005-01-03 devnull Scrolling the mouse wheel while the cursor points at the background
195 058b0118 2005-01-03 devnull will cycle through the virtual screens.
198 ad8d5423 2008-02-01 rsc moves or resizes every window whose X11 class or instance strings contain
201 ad8d5423 2008-02-01 rsc .I rectangle
202 ad8d5423 2008-02-01 rsc argument can be
203 ad8d5423 2008-02-01 rsc \fIwidth\^\^\fLx\fI\^\^height\fR,
204 ad8d5423 2008-02-01 rsc \fIwidth\^\^\fLx\fI\^\^height\^\^\fL@\fI\^\^xmin\fL,\fIxmax\fR,
205 ad8d5423 2008-02-01 rsc \fL'\fIxmin ymin xmax ymax\fL'\fR,
207 ad8d5423 2008-02-01 rsc \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
212 ad8d5423 2008-02-01 rsc causes the rectangle to be interpreted as a delta:
214 ad8d5423 2008-02-01 rsc nudges a window to the right, while
216 ad8d5423 2008-02-01 rsc grows a window.
217 ad8d5423 2008-02-01 rsc With no arguments,
219 ad8d5423 2008-02-01 rsc lists all the current X windows.
221 ad8d5423 2008-02-01 rsc is not specific to
223 ad8d5423 2008-02-01 rsc and can be used with other window managers.
224 ba19f6b5 2004-04-19 devnull .SH BUGS
226 ba19f6b5 2004-04-19 devnull Plan 9's
227 ba19f6b5 2004-04-19 devnull .IR rio ,
228 ba19f6b5 2004-04-19 devnull clicking button 2 or button 3 to select a window also sends that
229 ba19f6b5 2004-04-19 devnull event to the window itself. This
231 ba19f6b5 2004-04-19 devnull does not.
233 ba19f6b5 2004-04-19 devnull The command-line syntax is non-standard.
235 ba19f6b5 2004-04-19 devnull In Plan 9's
236 ba19f6b5 2004-04-19 devnull .IR rio ,
237 ba19f6b5 2004-04-19 devnull newly started applications take over the current window.
240 ba19f6b5 2004-04-19 devnull starts a new window for each program.
241 ba19f6b5 2004-04-19 devnull (In X11, it appears to be impossible to know which window
242 ba19f6b5 2004-04-19 devnull starts a particular program.)
244 ba19f6b5 2004-04-19 devnull There is a currently a compiled-in limit of 128 hidden windows.
245 ba19f6b5 2004-04-19 devnull .SH "SEE ALSO"
246 ba19f6b5 2004-04-19 devnull .IR 9term (1),
247 058b0118 2005-01-03 devnull .IR xterm (1)
249 6a0171e9 2005-01-14 devnull As mentioned above,
251 6a0171e9 2005-01-14 devnull is mainly maintenance updates
252 6a0171e9 2005-01-14 devnull applied to the original
254 6a0171e9 2005-01-14 devnull by David Hogan; see
255 6a0171e9 2005-01-14 devnull .HR http://unauthorised.org/dhog/9wm.html "" .