Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RIO(1)			    General Commands Manual			RIO(1)

       rio - rio-like Window Manager for X

       rio [ -font fontname ] [	-grey ]	[ -s ] [ -term termprog	] [ -version ]
       [ -virtuals num ] [ exit	| restart ]

       xshove [	name rectangle ]

       Rio is a	window manager for X which attempts to emulate the window man-
       agement	policies  of Plan 9's rio window manager.  Rio is derived from
       David Hogan's 9wm.

       The -grey option	makes the background stippled grey,  the  default  X11
       background, instead of solid grey, the Plan 9 background.

       The  -font  option sets the font	in rio's menu to fname,	overriding the
       default.	 Unlike	the other programs in the Plan 9  ports,  rio  expects
       this font to be an X11 font rather than a Plan 9	font.

       The  -term  option specifies an alternative program to run when the New
       menu item is selected.  The default is to try 9term(1) and then to fall
       back  to	 xterm(1).  The	-s option causes rio to	add -s to 9term's com-
       mand-line, starting the window in scrolling mode.

       The -version option prints the current version on standard error,  then

       The -virtuals option sets the number of virtual screens (the default is
       1, and the maximum is 12).

       If the argument exit or restart is given, it is sent to an already-run-
       ning rio, causing the extant rio	to exit	or restart.

   Using rio
       One  window  is	current, and is	indicated with a dark border and text;
       characters typed	on the keyboard	are available in the /dev/cons file of
       the process in the current window.  Characters written on /dev/cons ap-
       pear asynchronously in the associated window whether or not the	window
       is current.

       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  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:

       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 cre-
	      ated running termprog, by	default	9term(1) or, if	9term  is  not
	      available, xterm(1).

       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	New operation.	The window is made current.

       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-

       Delete Delete  a	 window.   Click in the	window to be deleted (gunsight
	      cursor).	Deleting a window causes a note	to be sent to all pro-
	      cesses in	the window's process group (see	notify(3)).

       Hide   Hide  a window.  Click in	the window to be hidden	(gunsight cur-
	      sor); it will be moved off-screen.  Each hidden window is	 given
	      a	 menu entry in the button 3 menu according to its current win-
	      dow system label.

       label  Restore a	hidden window.

       Windows may also	be arranged by dragging	their borders.	Pressing  but-
       ton  1 or 2 over	a window's border allows one to	move the corresponding
       edge or corner, while button 3 moves the	whole window.

       When the	mouse cursor points to the background area and	rio  has  been
       started	with  multiple	virtual	 screens  using	 the -virtuals option,
       clicking	button 2 brings	up a menu to select a virtual screen to	 view.
       Scrolling  the  mouse  wheel  while the cursor points at	the background
       will cycle through the virtual screens.

       Xshove moves or resizes	every  window  whose  X11  class  or  instance
       strings	contain	 name.	 The  rectangle	 argument can be widthxheight,
       widthxheight@xmin,xmax, 'xmin ymin xmax ymax', or  xmin,ymin,xmax,ymax.
       A  leading  +  or  - causes the rectangle to be interpreted as a	delta:
       nudges a	window to the right, while grows a window.  With no arguments,
       xshove  lists all the current X windows.	 Xshove	is not specific	to rio
       and can be used with other window managers.

       In Plan 9's rio,	clicking button	2 or button 3 to select	a window  also
       sends that event	to the window itself.  This rio	does not.

       The command-line	syntax is non-standard.

       In  Plan	9's rio, newly started applications take over the current win-
       dow.  This rio starts a new window for each program.  (In X11,  it  ap-
       pears  to  be  impossible to know which window starts a particular pro-

       There is	a currently a compiled-in limit	of 128 hidden windows.

       9term(1), xterm(1)

       As mentioned above, rio is mainly maintenance updates  applied  to  the
       original	9wm by David Hogan; see



Want to link to this manual page? Use this URL:

home | help