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