rio.1 (5643B)
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 "" .