Blob


1 .if t .ds 85 8\(12
2 .if n .ds 85 8-1/2
3 .TH RIO 1
4 .SH NAME
5 rio \- rio-like Window Manager for X
6 .SH SYNOPSIS
7 .B rio
8 [
9 .B \-grey
10 ] [
11 .B \-version
12 ] [
13 .B \-font
14 .I fname
15 ] [
16 .B \-term
17 .I termprog
18 ] [
19 .BR exit | restart
20 ]
21 .SH DESCRIPTION
22 .I Rio
23 is a window manager for X which attempts to emulate the window management
24 policies of Plan 9's
25 .I rio
26 window manager.
27 .PP
28 The
29 .B \-grey
30 option makes the background light grey, as does \*(85.
31 Use this option for maximum authenticity.
32 .B \-font
33 .I fname
34 sets the font in
35 .IR rio 's
36 menu to
37 .IR fname ,
38 overriding the default.
39 .B \-term
40 .I termprog
41 specifies an alternative program to run when the
42 .I New
43 menu item is selected.
44 .B \-version
45 prints the current version on standard error, then exits.
46 .PP
47 To make
48 .I rio
49 exit, you have to run
50 .B "rio exit"
51 on the command line. There is no ``exit'' menu item.
52 .PP
53 One window is
54 .IR current ,
55 and is indicated with a dark border and text;
56 characters typed on the keyboard are available in the
57 .B /dev/cons
58 file of the process in the current window.
59 Characters written on
60 .B /dev/cons
61 appear asynchronously in the associated window whether or not the window
62 is current.
63 .PP
64 Windows are created, deleted and rearranged using the mouse.
65 Clicking (pressing and releasing) mouse button 1 in a non-current
66 window makes that window current and brings it in front of
67 any windows that happen to be overlapping it.
68 When the mouse cursor points to the background area or is in
69 a window that has not claimed the mouse for its own use,
70 pressing mouse button 3 activates a
71 menu of window operations provided by
72 .IR rio .
73 Releasing button 3 then selects an operation.
74 At this point, a gunsight or cross cursor indicates that
75 an operation is pending.
76 The button 3 menu operations are:
77 .TF Resize
78 .TP
79 .B New
80 Create a window.
81 Press button 3 where one corner of the new rectangle should
82 appear (cross cursor), and move the mouse, while holding down button 3, to the
83 diagonally opposite corner.
84 Releasing button 3 creates the window, and makes it current.
85 Very small windows may not be created.
86 The new window is created running
87 .IR termprog ,
88 by default
89 .IR 9term (1)
90 or, if
91 .I 9term
92 is not available,
93 .IR xterm (1).
94 .TP
95 .B Resize
96 Change the size and location of a window.
97 First click button 3 in the window to be changed
98 (gunsight cursor).
99 Then sweep out a window as for the
100 .B New
101 operation.
102 The window is made current.
103 .TP
104 .B Move
105 Move a window to another location.
106 After pressing and holding button 3 over the window to be moved (gunsight cursor),
107 indicate the new position by dragging the rectangle to the new location.
108 The window is made current.
109 Windows may be moved partially off-screen.
110 .TP
111 .B Delete
112 Delete a window. Click in the window to be deleted (gunsight cursor).
113 Deleting a window causes a
114 .L hangup
115 note to be sent to all processes in the window's process group
116 (see
117 .IR notify (3)).
118 .TP
119 .B Hide
120 Hide a window. Click in the window to be hidden (gunsight cursor);
121 it will be moved off-screen.
122 Each hidden window is given a menu entry in the button 3 menu
123 according to its current window system label.
124 .TP
125 .I label
126 Restore a hidden window.
127 .PD
128 .PP
129 Windows may also be arranged by dragging their borders.
130 Pressing button 1 or 2 over a window's border allows one to
131 move the corresponding edge or corner, while button 3
132 moves the whole window.
133 .PD
134 .SH BUGS
135 In
136 Plan 9's
137 .IR rio ,
138 clicking button 2 or button 3 to select a window also sends that
139 event to the window itself. This
140 .I rio
141 does not.
142 .PP
143 The command-line syntax is non-standard.
144 .PP
145 In Plan 9's
146 .IR rio ,
147 newly started applications take over the current window.
148 This
149 .I rio
150 starts a new window for each program.
151 (In X11, it appears to be impossible to know which window
152 starts a particular program.)
153 .PP
154 There is a currently a compiled-in limit of 128 hidden windows.
155 .SH "SEE ALSO"
156 .IR 9term (1),
157 .IR xterm (1).