Blame


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
3 ba19f6b5 2004-04-19 devnull .TH RIO 1
4 ba19f6b5 2004-04-19 devnull .SH NAME
5 ba19f6b5 2004-04-19 devnull rio \- rio-like Window Manager for X
6 ba19f6b5 2004-04-19 devnull .SH SYNOPSIS
7 ba19f6b5 2004-04-19 devnull .B rio
8 ba19f6b5 2004-04-19 devnull [
9 ba19f6b5 2004-04-19 devnull .B \-grey
10 ba19f6b5 2004-04-19 devnull ] [
11 ba19f6b5 2004-04-19 devnull .B \-version
12 ba19f6b5 2004-04-19 devnull ] [
13 ba19f6b5 2004-04-19 devnull .B \-font
14 ba19f6b5 2004-04-19 devnull .I fname
15 ba19f6b5 2004-04-19 devnull ] [
16 ba19f6b5 2004-04-19 devnull .B \-term
17 ba19f6b5 2004-04-19 devnull .I termprog
18 ba19f6b5 2004-04-19 devnull ] [
19 ba19f6b5 2004-04-19 devnull .BR exit | restart
20 ba19f6b5 2004-04-19 devnull ]
21 ba19f6b5 2004-04-19 devnull .SH DESCRIPTION
22 ba19f6b5 2004-04-19 devnull .I Rio
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
25 ba19f6b5 2004-04-19 devnull .I rio
26 ba19f6b5 2004-04-19 devnull window manager.
27 ba19f6b5 2004-04-19 devnull .PP
28 ba19f6b5 2004-04-19 devnull The
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
33 ba19f6b5 2004-04-19 devnull .I fname
34 ba19f6b5 2004-04-19 devnull sets the font in
35 ba19f6b5 2004-04-19 devnull .IR rio 's
36 ba19f6b5 2004-04-19 devnull menu to
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
42 ba19f6b5 2004-04-19 devnull .I New
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.
46 ba19f6b5 2004-04-19 devnull .PP
47 ba19f6b5 2004-04-19 devnull To make
48 ba19f6b5 2004-04-19 devnull .I rio
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.
52 ba19f6b5 2004-04-19 devnull .PP
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.
63 ba19f6b5 2004-04-19 devnull .PP
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
78 ba19f6b5 2004-04-19 devnull .TP
79 ba19f6b5 2004-04-19 devnull .B New
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)
90 ba19f6b5 2004-04-19 devnull or, if
91 ba19f6b5 2004-04-19 devnull .I 9term
92 ba19f6b5 2004-04-19 devnull is not available,
93 ba19f6b5 2004-04-19 devnull .IR xterm (1).
94 ba19f6b5 2004-04-19 devnull .TP
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
100 ba19f6b5 2004-04-19 devnull .B New
101 ba19f6b5 2004-04-19 devnull operation.
102 ba19f6b5 2004-04-19 devnull The window is made current.
103 ba19f6b5 2004-04-19 devnull .TP
104 ba19f6b5 2004-04-19 devnull .B Move
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.
110 ba19f6b5 2004-04-19 devnull .TP
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
116 ba19f6b5 2004-04-19 devnull (see
117 ba19f6b5 2004-04-19 devnull .IR notify (3)).
118 ba19f6b5 2004-04-19 devnull .TP
119 ba19f6b5 2004-04-19 devnull .B Hide
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.
124 ba19f6b5 2004-04-19 devnull .TP
125 ba19f6b5 2004-04-19 devnull .I label
126 ba19f6b5 2004-04-19 devnull Restore a hidden window.
127 ba19f6b5 2004-04-19 devnull .PD
128 ba19f6b5 2004-04-19 devnull .PP
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.
133 ba19f6b5 2004-04-19 devnull .PD
134 ba19f6b5 2004-04-19 devnull .SH BUGS
135 ba19f6b5 2004-04-19 devnull In
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
140 ba19f6b5 2004-04-19 devnull .I rio
141 ba19f6b5 2004-04-19 devnull does not.
142 ba19f6b5 2004-04-19 devnull .PP
143 ba19f6b5 2004-04-19 devnull The command-line syntax is non-standard.
144 ba19f6b5 2004-04-19 devnull .PP
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.
148 ba19f6b5 2004-04-19 devnull This
149 ba19f6b5 2004-04-19 devnull .I rio
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.)
153 ba19f6b5 2004-04-19 devnull .PP
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).