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