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 and then to fall back  to
       The  -s	option	has no effect.	It formerly set	the scrolling mode for
       new windows and is recognized to	avoid breaking scripts.	 See for a de-
       scription of scrolling behavior.

       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	or, if 9term is	not available,

       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

       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.

       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