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