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 ba31ab30 2011-04-27 rsc option has no effect. It formerly set the scrolling mode for
77 ba31ab30 2011-04-27 rsc new windows and is recognized to avoid breaking scripts.
79 ba31ab30 2011-04-27 rsc .IR 9term (1)
80 ba31ab30 2011-04-27 rsc for a description of scrolling behavior.
83 ba19f6b5 2004-04-19 devnull .B \-version
85 ba19f6b5 2004-04-19 devnull prints the current version on standard error, then exits.
88 058b0118 2005-01-03 devnull .B \-virtuals
89 058b0118 2005-01-03 devnull option sets the number of virtual screens (the default is 1,
90 058b0118 2005-01-03 devnull and the maximum is 12).
92 058b0118 2005-01-03 devnull If the argument
95 058b0118 2005-01-03 devnull .B restart
96 058b0118 2005-01-03 devnull is given,
97 058b0118 2005-01-03 devnull it is sent to an already-running
98 058b0118 2005-01-03 devnull .IR rio ,
99 058b0118 2005-01-03 devnull causing the extant
101 058b0118 2005-01-03 devnull to exit or restart.
102 058b0118 2005-01-03 devnull .SS Using rio
104 ba19f6b5 2004-04-19 devnull One window is
105 ba19f6b5 2004-04-19 devnull .IR current ,
106 ba19f6b5 2004-04-19 devnull and is indicated with a dark border and text;
107 ba19f6b5 2004-04-19 devnull characters typed on the keyboard are available in the
108 ba19f6b5 2004-04-19 devnull .B /dev/cons
109 ba19f6b5 2004-04-19 devnull file of the process in the current window.
110 ba19f6b5 2004-04-19 devnull Characters written on
111 ba19f6b5 2004-04-19 devnull .B /dev/cons
112 ba19f6b5 2004-04-19 devnull appear asynchronously in the associated window whether or not the window
113 ba19f6b5 2004-04-19 devnull is current.
115 ba19f6b5 2004-04-19 devnull Windows are created, deleted and rearranged using the mouse.
116 ba19f6b5 2004-04-19 devnull Clicking (pressing and releasing) mouse button 1 in a non-current
117 ba19f6b5 2004-04-19 devnull window makes that window current and brings it in front of
118 ba19f6b5 2004-04-19 devnull any windows that happen to be overlapping it.
119 ba19f6b5 2004-04-19 devnull When the mouse cursor points to the background area or is in
120 ba19f6b5 2004-04-19 devnull a window that has not claimed the mouse for its own use,
121 ba19f6b5 2004-04-19 devnull pressing mouse button 3 activates a
122 ba19f6b5 2004-04-19 devnull menu of window operations provided by
123 ba19f6b5 2004-04-19 devnull .IR rio .
124 ba19f6b5 2004-04-19 devnull Releasing button 3 then selects an operation.
125 ba19f6b5 2004-04-19 devnull At this point, a gunsight or cross cursor indicates that
126 ba19f6b5 2004-04-19 devnull an operation is pending.
127 ba19f6b5 2004-04-19 devnull The button 3 menu operations are:
128 ba19f6b5 2004-04-19 devnull .TF Resize
131 ba19f6b5 2004-04-19 devnull Create a window.
132 ba19f6b5 2004-04-19 devnull Press button 3 where one corner of the new rectangle should
133 ba19f6b5 2004-04-19 devnull appear (cross cursor), and move the mouse, while holding down button 3, to the
134 ba19f6b5 2004-04-19 devnull diagonally opposite corner.
135 ba19f6b5 2004-04-19 devnull Releasing button 3 creates the window, and makes it current.
136 ba19f6b5 2004-04-19 devnull Very small windows may not be created.
137 ba19f6b5 2004-04-19 devnull The new window is created running
138 ba19f6b5 2004-04-19 devnull .IR termprog ,
139 ba19f6b5 2004-04-19 devnull by default
140 ba19f6b5 2004-04-19 devnull .IR 9term (1)
142 ba19f6b5 2004-04-19 devnull .I 9term
143 ba19f6b5 2004-04-19 devnull is not available,
144 ba19f6b5 2004-04-19 devnull .IR xterm (1).
146 ba19f6b5 2004-04-19 devnull .B Resize
147 ba19f6b5 2004-04-19 devnull Change the size and location of a window.
148 ba19f6b5 2004-04-19 devnull First click button 3 in the window to be changed
149 ba19f6b5 2004-04-19 devnull (gunsight cursor).
150 ba19f6b5 2004-04-19 devnull Then sweep out a window as for the
152 ba19f6b5 2004-04-19 devnull operation.
153 ba19f6b5 2004-04-19 devnull The window is made current.
156 ba19f6b5 2004-04-19 devnull Move a window to another location.
157 ba19f6b5 2004-04-19 devnull After pressing and holding button 3 over the window to be moved (gunsight cursor),
158 ba19f6b5 2004-04-19 devnull indicate the new position by dragging the rectangle to the new location.
159 ba19f6b5 2004-04-19 devnull The window is made current.
160 ba19f6b5 2004-04-19 devnull Windows may be moved partially off-screen.
162 ba19f6b5 2004-04-19 devnull .B Delete
163 ba19f6b5 2004-04-19 devnull Delete a window. Click in the window to be deleted (gunsight cursor).
164 ba19f6b5 2004-04-19 devnull Deleting a window causes a
165 ba19f6b5 2004-04-19 devnull .L hangup
166 ba19f6b5 2004-04-19 devnull note to be sent to all processes in the window's process group
168 ba19f6b5 2004-04-19 devnull .IR notify (3)).
171 ba19f6b5 2004-04-19 devnull Hide a window. Click in the window to be hidden (gunsight cursor);
172 ba19f6b5 2004-04-19 devnull it will be moved off-screen.
173 ba19f6b5 2004-04-19 devnull Each hidden window is given a menu entry in the button 3 menu
174 ba19f6b5 2004-04-19 devnull according to its current window system label.
176 ba19f6b5 2004-04-19 devnull .I label
177 ba19f6b5 2004-04-19 devnull Restore a hidden window.
180 ba19f6b5 2004-04-19 devnull Windows may also be arranged by dragging their borders.
181 ba19f6b5 2004-04-19 devnull Pressing button 1 or 2 over a window's border allows one to
182 ba19f6b5 2004-04-19 devnull move the corresponding edge or corner, while button 3
183 ba19f6b5 2004-04-19 devnull moves the whole window.
185 058b0118 2005-01-03 devnull When the mouse cursor points to the background area
188 058b0118 2005-01-03 devnull has been started with multiple virtual screens using the
189 058b0118 2005-01-03 devnull .B \-virtuals
191 058b0118 2005-01-03 devnull clicking button 2 brings up a menu to select a virtual screen to view.
192 058b0118 2005-01-03 devnull Scrolling the mouse wheel while the cursor points at the background
193 058b0118 2005-01-03 devnull will cycle through the virtual screens.
196 ad8d5423 2008-02-01 rsc moves or resizes every window whose X11 class or instance strings contain
199 ad8d5423 2008-02-01 rsc .I rectangle
200 ad8d5423 2008-02-01 rsc argument can be
201 ad8d5423 2008-02-01 rsc \fIwidth\^\^\fLx\fI\^\^height\fR,
202 ad8d5423 2008-02-01 rsc \fIwidth\^\^\fLx\fI\^\^height\^\^\fL@\fI\^\^xmin\fL,\fIxmax\fR,
203 ad8d5423 2008-02-01 rsc \fL'\fIxmin ymin xmax ymax\fL'\fR,
205 ad8d5423 2008-02-01 rsc \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
210 ad8d5423 2008-02-01 rsc causes the rectangle to be interpreted as a delta:
212 ad8d5423 2008-02-01 rsc nudges a window to the right, while
214 ad8d5423 2008-02-01 rsc grows a window.
215 ad8d5423 2008-02-01 rsc With no arguments,
217 ad8d5423 2008-02-01 rsc lists all the current X windows.
219 ad8d5423 2008-02-01 rsc is not specific to
221 ad8d5423 2008-02-01 rsc and can be used with other window managers.
222 ba19f6b5 2004-04-19 devnull .SH BUGS
224 ba19f6b5 2004-04-19 devnull Plan 9's
225 ba19f6b5 2004-04-19 devnull .IR rio ,
226 ba19f6b5 2004-04-19 devnull clicking button 2 or button 3 to select a window also sends that
227 ba19f6b5 2004-04-19 devnull event to the window itself. This
229 ba19f6b5 2004-04-19 devnull does not.
231 ba19f6b5 2004-04-19 devnull The command-line syntax is non-standard.
233 ba19f6b5 2004-04-19 devnull In Plan 9's
234 ba19f6b5 2004-04-19 devnull .IR rio ,
235 ba19f6b5 2004-04-19 devnull newly started applications take over the current window.
238 ba19f6b5 2004-04-19 devnull starts a new window for each program.
239 ba19f6b5 2004-04-19 devnull (In X11, it appears to be impossible to know which window
240 ba19f6b5 2004-04-19 devnull starts a particular program.)
242 ba19f6b5 2004-04-19 devnull There is a currently a compiled-in limit of 128 hidden windows.
243 ba19f6b5 2004-04-19 devnull .SH "SEE ALSO"
244 ba19f6b5 2004-04-19 devnull .IR 9term (1),
245 058b0118 2005-01-03 devnull .IR xterm (1)
247 6a0171e9 2005-01-14 devnull As mentioned above,
249 6a0171e9 2005-01-14 devnull is mainly maintenance updates
250 6a0171e9 2005-01-14 devnull applied to the original
252 6a0171e9 2005-01-14 devnull by David Hogan; see
253 6a0171e9 2005-01-14 devnull .HR http://unauthorised.org/dhog/9wm.html "" .