diff options
author | rsc <devnull@localhost> | 2004-04-19 15:51:52 +0000 |
---|---|---|
committer | rsc <devnull@localhost> | 2004-04-19 15:51:52 +0000 |
commit | ba19f6b5b46c539f9f2821d351837164b5824f04 (patch) | |
tree | eba8c5fd72c21403f140fed791673fc875cbe885 /man/man1/rio.1 | |
parent | 2b522d7aaa180f5326778b43f331d73c4bd96654 (diff) | |
download | plan9port-ba19f6b5b46c539f9f2821d351837164b5824f04.tar.gz plan9port-ba19f6b5b46c539f9f2821d351837164b5824f04.tar.bz2 plan9port-ba19f6b5b46c539f9f2821d351837164b5824f04.zip |
some needed manual pages
Diffstat (limited to 'man/man1/rio.1')
-rw-r--r-- | man/man1/rio.1 | 157 |
1 files changed, 157 insertions, 0 deletions
diff --git a/man/man1/rio.1 b/man/man1/rio.1 new file mode 100644 index 00000000..9af90e81 --- /dev/null +++ b/man/man1/rio.1 @@ -0,0 +1,157 @@ +.if t .ds 85 8\(12 +.if n .ds 85 8-1/2 +.TH RIO 1 +.SH NAME +rio \- rio-like Window Manager for X +.SH SYNOPSIS +.B rio +[ +.B \-grey +] [ +.B \-version +] [ +.B \-font +.I fname +] [ +.B \-term +.I termprog +] [ +.BR exit | restart +] +.SH DESCRIPTION +.I Rio +is a window manager for X which attempts to emulate the window management +policies of Plan 9's +.I rio +window manager. +.PP +The +.B \-grey +option makes the background light grey, as does \*(85. +Use this option for maximum authenticity. +.B \-font +.I fname +sets the font in +.IR rio 's +menu to +.IR fname , +overriding the default. +.B \-term +.I termprog +specifies an alternative program to run when the +.I New +menu item is selected. +.B \-version +prints the current version on standard error, then exits. +.PP +To make +.I rio +exit, you have to run +.B "rio exit" +on the command line. There is no ``exit'' menu item. +.PP +One window is +.IR current , +and is indicated with a dark border and text; +characters typed on the keyboard are available in the +.B /dev/cons +file of the process in the current window. +Characters written on +.B /dev/cons +appear asynchronously in the associated window whether or not the window +is current. +.PP +Windows are created, deleted and rearranged using the mouse. +Clicking (pressing and releasing) mouse button 1 in a non-current +window makes that window current and brings it in front of +any windows that happen to be overlapping it. +When the mouse cursor points to the background area or is in +a window that has not claimed the mouse for its own use, +pressing mouse button 3 activates a +menu of window operations provided by +.IR rio . +Releasing button 3 then selects an operation. +At this point, a gunsight or cross cursor indicates that +an operation is pending. +The button 3 menu operations are: +.TF Resize +.TP +.B New +Create a window. +Press button 3 where one corner of the new rectangle should +appear (cross cursor), and move the mouse, while holding down button 3, to the +diagonally opposite corner. +Releasing button 3 creates the window, and makes it current. +Very small windows may not be created. +The new window is created running +.IR termprog , +by default +.IR 9term (1) +or, if +.I 9term +is not available, +.IR xterm (1). +.TP +.B Resize +Change the size and location of a window. +First click button 3 in the window to be changed +(gunsight cursor). +Then sweep out a window as for the +.B New +operation. +The window is made current. +.TP +.B Move +Move a window to another location. +After pressing and holding button 3 over the window to be moved (gunsight cursor), +indicate the new position by dragging the rectangle to the new location. +The window is made current. +Windows may be moved partially off-screen. +.TP +.B Delete +Delete a window. Click in the window to be deleted (gunsight cursor). +Deleting a window causes a +.L hangup +note to be sent to all processes in the window's process group +(see +.IR notify (3)). +.TP +.B Hide +Hide a window. Click in the window to be hidden (gunsight cursor); +it will be moved off-screen. +Each hidden window is given a menu entry in the button 3 menu +according to its current window system label. +.TP +.I label +Restore a hidden window. +.PD +.PP +Windows may also be arranged by dragging their borders. +Pressing button 1 or 2 over a window's border allows one to +move the corresponding edge or corner, while button 3 +moves the whole window. +.PD +.SH BUGS +In +Plan 9's +.IR rio , +clicking button 2 or button 3 to select a window also sends that +event to the window itself. This +.I rio +does not. +.PP +The command-line syntax is non-standard. +.PP +In Plan 9's +.IR rio , +newly started applications take over the current window. +This +.I rio +starts a new window for each program. +(In X11, it appears to be impossible to know which window +starts a particular program.) +.PP +There is a currently a compiled-in limit of 128 hidden windows. +.SH "SEE ALSO" +.IR 9term (1), +.IR xterm (1). |