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

FreeBSD Manual Pages


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

       xwit - window interface tool: pop or iconify this xterm window or named

       xwit [-display display] [-sync] [-pop] [-focus] [-iconify] [-unmap]
	    [-raise] [-lower] [-opposite] [-[un]circulate]
	    [-resize w h] [-rows r] [-columns c] [-[r]move x y]
	    [-[r]warp x	y] [-colormap colormapid] [-[no]save]
	    [-name name] [-iconname name]
	    [-bitmap file] [-mask file]	[-[r]iconmove x	y]
	    [-[no]backingstore]	[-[no]saveunder]
	    [-[no]keyrepeat keycode ...	keycode	- keycode ...]
	    [-id windowid] [-root] [-current] [-select]	 [-all]	 [-names  ini-

       xwit is an X window interface tool.  By default when used with no argu-
       ments in	an xterm it de-iconifies and raises the	window.	 You can spec-
       ify  a different	function to do,	such as	iconifying the window, and ap-
       ply it to several windows whose name  begins  with  one	of  the	 given
       strings,	or a particular	window id given, or the	window id found	in the
       environment variable WINDOWID (which is set by xterm for	the program it
       runs), or the window under the mouse cursor.

	      is followed by the display to open.

       -sync  causes all X requests to be performed synchronously.

       -property property
	      causes  the specified property to	be used	instead	of the windows
	      name (which is WM_NAME).	Some possible  values  are:  WM_CLASS,

       -pop   is the default action.  It need only be given if it is wanted as
	      well as some other function.

       -focus will give	the input focus	to the specified window.

	      will iconify the windows instead of popping them.

       -unmap will iconify windows by unmapping	with  a	 non  ICCCM  compliant
	      window  manager.	 (Beware,  this	option is not usually what you

       -raise raise windows (but do not	map them if unmapped).

       -lower lower windows.

	      toggle the stacking of windows from  top	to  bottom  among  any
	      overlapping windows.

	      circulate	a window's subwindows forward. Use this	with -root.

	      circulate	a window's subwindows backward.	Use this with -root.

       -resize w h
	      resize windows to	the given pixel	size.

       -rows r
	      resize windows to	the given number of rows.

       -columns	c
	      resize windows to	the given number of columns.

       -move x y
	      move windows to the given	absolute position relative to its par-
	      ent.  (If	the x or y value is negative it	is taken  relative  to
	      the right	or bottom edge of the parent.)

       -rmove x	y
	      move windows by the given	relative amount.

       -warp x y
	      move  the	cursor to the given position relative to the specified
	      window.  Add -root to warp to an absolute	position.

       -rwarp x	y
	      move the cursor by the given relative amount.

       -colormap colormapid
	      install the given	colormap into the given	window.	 -save -nosave
	      immediately enable or disable the	screen saver.

       -name name
	      set the WM_NAME property to the given string.

       -iconname name
	      set the WM_ICON_NAME property to the given string.

       -bitmap file
	      use the given bitmap file	as the icon bitmap for the window.

       -mask file
	      use the given bitmap file	as the icon mask for the window.

       -iconmove x y
	      move  icons to the given absolute	position.  (Will not work with
	      some window managers.)

       -riconmove x y
	      move icons by the	given relative amount.	(Will  not  work  with
	      some window managers.)

       -backingstore -bs -nobackingstore -nobs
	      enable or	disable	backing	store for the window.

       -saveunder -su -nosaveunder -nosu
	      enable or	disable	saveunders for the window.

       -keyrepeat -nokeyrepeat
	      is  followed  by	a  list	 of  keycodes  (decimal	 numbers,  see
	      xmodmap(1)).  A range can	be specified as	a lower	number,	``-'',
	      and  upper  number  as three separate arguments.	The individual
	      setting of auto-repeat for those keycodes	is set on or off.  The
	      global  setting  of  auto-repeat	can be set with	xset(1).  When
	      off, no keys will	repeat.

       -print will print the id, the coordinates, the depth and	 the  name  of
	      all  selected  windows.  If -property is given, that one will be
	      printed instead of the name.

       Window Selection
	      If no window is specified, $WINDOWID will	be used	if set;	other-
	      wise the window under the	cursor will be selected.

       -id    is followed by a single window number, in	decimal; or, if	it be-
	      gins with	0x, in hexadecimal.

       -root  selects the root window.

	      selects the window under the cursor (default if no window	speci-
	      fied and $WINDOWID not set).

	      allows the user to interactively select a	window with the	mouse.

       -all   is equivalent to -names '', as easier to remember.

       -names if  given	 must  be the last option and is followed by a list of
	      strings.	All windows that have a	name that begins exactly  like
	      one  of  the strings will	be acted upon.	If -property is	given,
	      this property is used instead of the  name.   By	using  a  null
	      string (-names ''), all names will be matched.

       To de-iconify and pop ``this'' xterm and	warp the cursor	into it:

		 xwit -pop -warp 50 50

       To  interactively select	an xterm, and resize it	to 34 rows and 80 col-

		 xwit -select -rows 34 -columns	80

       To gently agitate your oclock on	the screen:

		 while	 xwit -rmove 0 10 -names oclock
		 do	 xwit -rmove 0 -10 -names oclock

       Exit status is 0	if any action is taken,	1 if  no  window  matches  the
       list supplied to	-names,	2 if an	error occurs.

       Since  each  application	 is supposed to	request	these functions	of the
       window manager, some of them may	not like other clients mapping and un-
       mapping	them  behind  their  backs.  Iconification is requested	of the
       window manager using the	ICCCM.	Non ICCCM  compliant  window  managers
       may not react correctly.

       Mark M Martin, CETIA France,
       David DiGiacomo,

       Thanks  to  Andre Delafontaine, Norman R. McBride, Keith	Thompson, Glen
       R. Walker, Michael Mauch, Dima Barsky and Decklin Foster	 for  bug  re-
       ports, suggestions and/or patches.

				  2 Dec	2005			       XWIT(1)


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

home | help