1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
<head>
<title>rio(1) - Plan 9 from User Space</title>
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
</head>
<body bgcolor=#ffffff>
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=10><td>
<tr><td width=20><td>
<tr><td width=20><td><b>RIO(1)</b><td align=right><b>RIO(1)</b>
<tr><td width=20><td colspan=2>
<br>
<p><font size=+1><b>NAME </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
rio – rio-like Window Manager for X<br>
</table>
<p><font size=+1><b>SYNOPSIS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>rio</font></tt> [ <tt><font size=+1>–font</font></tt> <i>fontname</i> ] [ <tt><font size=+1>–grey</font></tt> ] [ <tt><font size=+1>–s</font></tt> ] [ <tt><font size=+1>–term</font></tt> <i>termprog</i> ] [ <tt><font size=+1>–version</font></tt>
] [ <tt><font size=+1>–virtuals</font></tt> <i>num</i> ] [ <tt><font size=+1>exit</font></tt> | <tt><font size=+1>restart</font></tt> ]<br>
</table>
<p><font size=+1><b>DESCRIPTION </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<i>Rio</i> is a window manager for X which attempts to emulate the window
management policies of Plan 9’s <i>rio</i> window manager. Rio is derived
from David Hogan’s 8½.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The <tt><font size=+1>–grey</font></tt> option makes the background stippled grey, the default
X11 background, instead of solid grey, the Plan 9 background.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The <tt><font size=+1>–font</font></tt> option sets the font in <i>rio</i>’s menu to <i>fname</i>, overriding
the default. Unlike the other programs in the Plan 9 ports, rio
expects this font to be an X11 font rather than a Plan 9 font.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The <tt><font size=+1>–term</font></tt> option specifies an alternative program to run when the
<i>New</i> menu item is selected. The default is to try <a href="../man1/9term.html"><i>9term</i>(1)</a> and
then to fall back to <a href="../man1/xterm.html"><i>xterm</i>(1)</a>. The <tt><font size=+1>–s</font></tt> option causes <i>rio</i> to add
<tt><font size=+1>−s</font></tt> to <i>9term</i>’s command-line, starting the window in scrolling mode.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The <tt><font size=+1>–version</font></tt> option prints the current version on standard error,
then exits.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The <tt><font size=+1>–virtuals</font></tt> option sets the number of virtual screens (the default
is 1, and the maximum is 12).
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
If the argument <tt><font size=+1>exit</font></tt> or <tt><font size=+1>restart</font></tt> is given, it is sent to an already-running
<i>rio</i>, causing the extant <i>rio</i> to exit or restart.<br>
<p><font size=+1><b>Using rio </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
One window is <i>current</i>, and is indicated with a dark border and
text; characters typed on the keyboard are available in the <tt><font size=+1>/dev/cons</font></tt>
file of the process in the current window. Characters written
on <tt><font size=+1>/dev/cons</font></tt> appear asynchronously in the associated window whether
or not the window is current.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Windows are created, deleted and rearranged using the mouse. Clicking
(pressing and releasing) mouse button 1 in a non-current window
makes that window current and brings it in front of any windows
that happen to be overlapping it. When the mouse cursor points
to the background area or is in a window that has
not claimed the mouse for its own use, pressing mouse button 3
activates a menu of window operations provided by <i>rio</i>. Releasing
button 3 then selects an operation. At this point, a gunsight
or cross cursor indicates that an operation is pending. The button
3 menu operations are:<br>
<tt><font size=+1>New</font></tt> Create a window. Press button 3 where one corner of the new
rectangle should appear (cross cursor), and move the mouse, while
holding down button 3, to the diagonally opposite corner. Releasing
button 3 creates the window, and makes it current. Very small
windows may not be created. The new
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
window is created running <i>termprog</i>, by default <a href="../man1/9term.html"><i>9term</i>(1)</a> or, if
<i>9term</i> is not available, <a href="../man1/xterm.html"><i>xterm</i>(1)</a>.<br>
</table>
</table>
<tt><font size=+1>Resize</font></tt> Change the size and location of a window. First click button
3 in the window to be changed (gunsight cursor). Then sweep out
a window as for the <tt><font size=+1>New</font></tt> operation. The window is made current.<br>
<tt><font size=+1>Move</font></tt> Move a window to another location. After pressing and holding
button 3 over the window to be moved (gunsight cursor), indicate
the new position by dragging the rectangle to the new location.
The window is made current. Windows may be moved partially off-screen.<br>
<tt><font size=+1>Delete</font></tt> Delete a window. Click in the window to be deleted (gunsight
cursor). Deleting a window causes a <tt><font size=+1>hangup</font></tt> note to be sent to
all processes in the window’s process group (see <a href="../man3/notify.html"><i>notify</i>(3)</a>).<br>
<tt><font size=+1>Hide</font></tt> Hide a window. Click in the window to be hidden (gunsight
cursor); it will be moved off-screen. Each hidden window is given
a menu entry in the button 3 menu according to its current window
system label.<br>
<i>label</i> Restore a hidden window.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Windows may also be arranged by dragging their borders. Pressing
button 1 or 2 over a window’s border allows one to move the corresponding
edge or corner, while button 3 moves the whole window.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
When the mouse cursor points to the background area and <i>rio</i> has
been started with multiple virtual screens using the <tt><font size=+1>–virtuals</font></tt>
option, clicking button 2 brings up a menu to select a virtual
screen to view. Scrolling the mouse wheel while the cursor points
at the background will cycle through the virtual screens.
</table>
<p><font size=+1><b>BUGS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
In Plan 9’s <i>rio</i>, clicking button 2 or button 3 to select a window
also sends that event to the window itself. This <i>rio</i> does not.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
The command-line syntax is non-standard.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
In Plan 9’s <i>rio</i>, newly started applications take over the current
window. This <i>rio</i> starts a new window for each program. (In X11,
it appears to be impossible to know which window starts a particular
program.)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
There is a currently a compiled-in limit of 128 hidden windows.<br>
</table>
<p><font size=+1><b>SEE ALSO </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<a href="../man1/9term.html"><i>9term</i>(1)</a>, <a href="../man1/xterm.html"><i>xterm</i>(1)</a><br>
</table>
<td width=20>
<tr height=20><td>
</table>
<!-- TRAILER -->
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=15><td width=10><td><td width=10>
<tr><td><td>
<center>
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
</center>
</table>
<!-- TRAILER -->
</body></html>
|