Blob


1 .TH RIO 1
2 .SH NAME
3 rio \- rio-like Window Manager for X
4 .SH SYNOPSIS
5 .B rio
6 [
7 .B \-font
8 .I fontname
9 ]
10 [
11 .B \-grey
12 ]
13 [
14 .B \-s
15 ]
16 [
17 .B \-term
18 .I termprog
19 ]
20 [
21 .B \-version
22 ]
23 [
24 .B \-virtuals
25 .I num
26 ]
27 [
28 .B exit
29 |
30 .B restart
31 ]
32 .PP
33 .B xshove
34 [
35 .I name
36 .I rectangle
37 ]
38 .SH DESCRIPTION
39 .if t .ds 85 8\(12
40 .if n .ds 85 8-1/2
41 .I Rio
42 is a window manager for X which attempts to emulate the window management
43 policies of Plan 9's
44 .I rio
45 window manager.
46 Rio is derived from David Hogan's 9wm.
47 .PP
48 The
49 .B \-grey
50 option makes the background stippled grey, the default X11 background,
51 instead of solid grey, the Plan 9 background.
52 .PP
53 The
54 .B \-font
55 option
56 sets the font in
57 .IR rio 's
58 menu to
59 .IR fname ,
60 overriding the default.
61 Unlike the other programs in the Plan 9 ports, rio expects this
62 font to be an X11 font rather than a Plan 9 font.
63 .PP
64 The
65 .B \-term
66 option
67 specifies an alternative program to run when the
68 .I New
69 menu item is selected.
70 The default is to try
71 .MR 9term (1)
72 and then to fall back to
73 .MR xterm (1) .
74 The
75 .B \-s
76 option has no effect. It formerly set the scrolling mode for
77 new windows and is recognized to avoid breaking scripts.
78 See
79 .MR 9term (1)
80 for a description of scrolling behavior.
81 .PP
82 The
83 .B \-version
84 option
85 prints the current version on standard error, then exits.
86 .PP
87 The
88 .B \-virtuals
89 option sets the number of virtual screens (the default is 1,
90 and the maximum is 12).
91 .PP
92 If the argument
93 .B exit
94 or
95 .B restart
96 is given,
97 it is sent to an already-running
98 .IR rio ,
99 causing the extant
100 .I rio
101 to exit or restart.
102 .SS Using rio
103 .PP
104 One window is
105 .IR current ,
106 and is indicated with a dark border and text;
107 characters typed on the keyboard are available in the
108 .B /dev/cons
109 file of the process in the current window.
110 Characters written on
111 .B /dev/cons
112 appear asynchronously in the associated window whether or not the window
113 is current.
114 .PP
115 Windows are created, deleted and rearranged using the mouse.
116 Clicking (pressing and releasing) mouse button 1 in a non-current
117 window makes that window current and brings it in front of
118 any windows that happen to be overlapping it.
119 When the mouse cursor points to the background area or is in
120 a window that has not claimed the mouse for its own use,
121 pressing mouse button 3 activates a
122 menu of window operations provided by
123 .IR rio .
124 Releasing button 3 then selects an operation.
125 At this point, a gunsight or cross cursor indicates that
126 an operation is pending.
127 The button 3 menu operations are:
128 .TF Resize
129 .TP
130 .B New
131 Create a window.
132 Press button 3 where one corner of the new rectangle should
133 appear (cross cursor), and move the mouse, while holding down button 3, to the
134 diagonally opposite corner.
135 Releasing button 3 creates the window, and makes it current.
136 Very small windows may not be created.
137 The new window is created running
138 .IR termprog ,
139 by default
140 .MR 9term (1)
141 or, if
142 .I 9term
143 is not available,
144 .MR xterm (1) .
145 .TP
146 .B Resize
147 Change the size and location of a window.
148 First click button 3 in the window to be changed
149 (gunsight cursor).
150 Then sweep out a window as for the
151 .B New
152 operation.
153 The window is made current.
154 .TP
155 .B Move
156 Move a window to another location.
157 After pressing and holding button 3 over the window to be moved (gunsight cursor),
158 indicate the new position by dragging the rectangle to the new location.
159 The window is made current.
160 Windows may be moved partially off-screen.
161 .TP
162 .B Delete
163 Delete a window. Click in the window to be deleted (gunsight cursor).
164 Deleting a window causes a
165 .L hangup
166 note to be sent to all processes in the window's process group
167 (see
168 .MR notify (3) ).
169 .TP
170 .B Hide
171 Hide a window. Click in the window to be hidden (gunsight cursor);
172 it will be moved off-screen.
173 Each hidden window is given a menu entry in the button 3 menu
174 according to its current window system label.
175 .TP
176 .I label
177 Restore a hidden window.
178 .PD
179 .PP
180 Windows may also be arranged by dragging their borders.
181 Pressing button 1 or 2 over a window's border allows one to
182 move the corresponding edge or corner, while button 3
183 moves the whole window.
184 .PP
185 When the mouse cursor points to the background area
186 and
187 .I rio
188 has been started with multiple virtual screens using the
189 .B \-virtuals
190 option,
191 clicking button 2 brings up a menu to select a virtual screen to view.
192 Scrolling the mouse wheel while the cursor points at the background
193 will cycle through the virtual screens.
194 .PP
195 .I Xshove
196 moves or resizes every window whose X11 class or instance strings contain
197 .IR name .
198 The
199 .I rectangle
200 argument can be
201 \fIwidth\^\^\fLx\fI\^\^height\fR,
202 \fIwidth\^\^\fLx\fI\^\^height\^\^\fL@\fI\^\^xmin\fL,\fIxmax\fR,
203 \fL'\fIxmin ymin xmax ymax\fL'\fR,
204 \fRor
205 \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
206 A leading
207 .B +
208 or
209 .B -
210 causes the rectangle to be interpreted as a delta:
211 .L +10,0
212 nudges a window to the right, while
213 .L +100x100
214 grows a window.
215 With no arguments,
216 .I xshove
217 lists all the current X windows.
218 .I Xshove
219 is not specific to
220 .I rio
221 and can be used with other window managers.
222 .SH BUGS
223 In
224 Plan 9's
225 .IR rio ,
226 clicking button 2 or button 3 to select a window also sends that
227 event to the window itself. This
228 .I rio
229 does not.
230 .PP
231 The command-line syntax is non-standard.
232 .PP
233 In Plan 9's
234 .IR rio ,
235 newly started applications take over the current window.
236 This
237 .I rio
238 starts a new window for each program.
239 (In X11, it appears to be impossible to know which window
240 starts a particular program.)
241 .PP
242 There is a currently a compiled-in limit of 128 hidden windows.
243 .SH "SEE ALSO"
244 .MR 9term (1) ,
245 .MR xterm (1)
246 .PP
247 As mentioned above,
248 .I rio
249 is mainly maintenance updates
250 applied to the original
251 .I 9wm
252 by David Hogan; see
253 .HR http://unauthorised.org/dhog/9wm.html "" .