XCONFIRM(1)	       UNIX System V		   XCONFIRM(1)



     NAME    [Toc]    [Back]
	  xconfirm - general purpose dialog box

     SYNOPSIS    [Toc]    [Back]
	  xconfirm [ -c	] [ -b button-name ] [ -B default-buttonname
 ] [	-t string ] [ -file filename ]
	       [ -icon icontype	] [ -font font ] [ -header titlebarstring
 ]	[ -geometry geometry-string ] [	-useslider ]
	       [ -noframe ] [ -exclusive ]

     DESCRIPTION    [Toc]    [Back]
	  xconfirm displays a  line  of	 text  for  each  -t  argument
	  specified (or	a file when the	-file argument is used), and a
	  button for each -b argument  specified.   When  one  of  the
	  buttons  is  pressed,	the label of that button is written to
	  xconfirm's standard output.  The  enter  key	activates  the
	  specified   default	button.	  This	provides  a  means  of
	  communication/feedback from within shell scripts and a means
	  to display useful information	to a user from an application.

	  Command line options are available to	specify	geometry, font
	  style, frame style, modality and one of five different icons
	  to be	presented for tailored visual feedback to the user.


	  -c   Center the window on the	display.  Ignored if  position
	       is specified via	-geometry.

	  -b button-name
	       Displays	a  button  with	 the  label  button-name.   If
	       button-name  is	the  empty  string, the	button in that
	       position	is not displayed.   If	no  -b	arguments  are
	       present,	 the  default  is  a  button  with  the	 label
	       Continue.

	  -B button-name
	       Displays	 a  button  with  the  label  button-name  and
	       specifies  it  as the button to be activated when enter
	       is pressed.

	  -t message
	       Displays	message.  Up to	10 strings can	be  listed  on
	       the  command  line  (each  must be preceded with	the -t
	       option).

	  -file	filename
	       Displays	the file filename.  All	 -t  options  will  be
	       ignored.

	  -icon	icontype
	       Displays	the icon icontype where	icontype  is  one  of:
	       info,  error,  question,	 progress,  warning, critical.



     Page 1					     (printed 10/9/01)






     XCONFIRM(1)	       UNIX System V		   XCONFIRM(1)



	       See the Motif Style Guide for guidance in selecting  an
	       appropriate  icon  type.	  action is also accepted as a
	       synonym for error for backware compatibility.

	  -font	fontname
	       Use fontname as the font.

	  -header string
	       Use string as the window	title.

	  -geometry geometry-string
	       This provides xconfirm with  an	X-compatible  geometry
	       string specification.

	  -useslider
	       When  displaying	 a  file,  use	a  slider  instead  of
	       clipping	to the window size.

	  -noframe
	       Do not display a	frame around the contents.

	  -exclusive
	       Grab the	keyboard/pointer  and  do  not	allow  further
	       input until a button is pressed.

     EXAMPLE    [Toc]    [Back]
	  The following	shell script will display  a  window  with  an
	  information  icon, asking the	user a yes or no question with
	  "Yes"	as the default.

	  #! /bin/sh
	  case `xconfirm -t "Really power down the system?" -b No -B Yes -icon info`
	  in
	     Yes) shutdown;;
	     No) ;;
	  esac


     CAVEATS    [Toc]    [Back]
	  Xconfirm will	resize the window vertically -t	arguments  are
	  used.	  Xconfirm  will  also	attempt	to resize horizontally
	  (for files this is based on the  longest  of	the  first  20
	  lines	 of  the file, so long lines may be truncated unless a
	  -geometry argument is	given),	so if users  specify  a	 large
	  number  of  buttons,	they  may  not	all  appear  unless  a
	  -geometry argument is	given.






     Page 2					     (printed 10/9/01)