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 .IR 9term (1)
72 and then to fall back to
73 .IR xterm (1).
74 The
75 .B \-s
76 option causes
77 .I rio
78 to add
79 .B -s
80 to
81 .IR 9term 's
82 command-line, starting the window in scrolling mode.
83 .PP
84 The
85 .B \-version
86 option
87 prints the current version on standard error, then exits.
88 .PP
89 The
90 .B \-virtuals
91 option sets the number of virtual screens (the default is 1,
92 and the maximum is 12).
93 .PP
94 If the argument
95 .B exit
96 or
97 .B restart
98 is given,
99 it is sent to an already-running
100 .IR rio ,
101 causing the extant
102 .I rio
103 to exit or restart.
104 .SS Using rio
105 .PP
106 One window is
107 .IR current ,
108 and is indicated with a dark border and text;
109 characters typed on the keyboard are available in the
110 .B /dev/cons
111 file of the process in the current window.
112 Characters written on
113 .B /dev/cons
114 appear asynchronously in the associated window whether or not the window
115 is current.
116 .PP
117 Windows are created, deleted and rearranged using the mouse.
118 Clicking (pressing and releasing) mouse button 1 in a non-current
119 window makes that window current and brings it in front of
120 any windows that happen to be overlapping it.
121 When the mouse cursor points to the background area or is in
122 a window that has not claimed the mouse for its own use,
123 pressing mouse button 3 activates a
124 menu of window operations provided by
125 .IR rio .
126 Releasing button 3 then selects an operation.
127 At this point, a gunsight or cross cursor indicates that
128 an operation is pending.
129 The button 3 menu operations are:
130 .TF Resize
131 .TP
132 .B New
133 Create a window.
134 Press button 3 where one corner of the new rectangle should
135 appear (cross cursor), and move the mouse, while holding down button 3, to the
136 diagonally opposite corner.
137 Releasing button 3 creates the window, and makes it current.
138 Very small windows may not be created.
139 The new window is created running
140 .IR termprog ,
141 by default
142 .IR 9term (1)
143 or, if
144 .I 9term
145 is not available,
146 .IR xterm (1).
147 .TP
148 .B Resize
149 Change the size and location of a window.
150 First click button 3 in the window to be changed
151 (gunsight cursor).
152 Then sweep out a window as for the
153 .B New
154 operation.
155 The window is made current.
156 .TP
157 .B Move
158 Move a window to another location.
159 After pressing and holding button 3 over the window to be moved (gunsight cursor),
160 indicate the new position by dragging the rectangle to the new location.
161 The window is made current.
162 Windows may be moved partially off-screen.
163 .TP
164 .B Delete
165 Delete a window. Click in the window to be deleted (gunsight cursor).
166 Deleting a window causes a
167 .L hangup
168 note to be sent to all processes in the window's process group
169 (see
170 .IR notify (3)).
171 .TP
172 .B Hide
173 Hide a window. Click in the window to be hidden (gunsight cursor);
174 it will be moved off-screen.
175 Each hidden window is given a menu entry in the button 3 menu
176 according to its current window system label.
177 .TP
178 .I label
179 Restore a hidden window.
180 .PD
181 .PP
182 Windows may also be arranged by dragging their borders.
183 Pressing button 1 or 2 over a window's border allows one to
184 move the corresponding edge or corner, while button 3
185 moves the whole window.
186 .PP
187 When the mouse cursor points to the background area
188 and
189 .I rio
190 has been started with multiple virtual screens using the
191 .B \-virtuals
192 option,
193 clicking button 2 brings up a menu to select a virtual screen to view.
194 Scrolling the mouse wheel while the cursor points at the background
195 will cycle through the virtual screens.
196 .PP
197 .I Xshove
198 moves or resizes every window whose X11 class or instance strings contain
199 .IR name .
200 The
201 .I rectangle
202 argument can be
203 \fIwidth\^\^\fLx\fI\^\^height\fR,
204 \fIwidth\^\^\fLx\fI\^\^height\^\^\fL@\fI\^\^xmin\fL,\fIxmax\fR,
205 \fL'\fIxmin ymin xmax ymax\fL'\fR,
206 \fRor
207 \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
208 A leading
209 .B +
210 or
211 .B -
212 causes the rectangle to be interpreted as a delta:
213 .L +10,0
214 nudges a window to the right, while
215 .L +100x100
216 grows a window.
217 With no arguments,
218 .I xshove
219 lists all the current X windows.
220 .I Xshove
221 is not specific to
222 .I rio
223 and can be used with other window managers.
224 .SH BUGS
225 In
226 Plan 9's
227 .IR rio ,
228 clicking button 2 or button 3 to select a window also sends that
229 event to the window itself. This
230 .I rio
231 does not.
232 .PP
233 The command-line syntax is non-standard.
234 .PP
235 In Plan 9's
236 .IR rio ,
237 newly started applications take over the current window.
238 This
239 .I rio
240 starts a new window for each program.
241 (In X11, it appears to be impossible to know which window
242 starts a particular program.)
243 .PP
244 There is a currently a compiled-in limit of 128 hidden windows.
245 .SH "SEE ALSO"
246 .IR 9term (1),
247 .IR xterm (1)
248 .PP
249 As mentioned above,
250 .I rio
251 is mainly maintenance updates
252 applied to the original
253 .I 9wm
254 by David Hogan; see
255 .HR http://unauthorised.org/dhog/9wm.html "" .