xconfirm(1)

     NAME
          xconfirm - general purpose dialog box

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

     DESCRIPTION
          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.
               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
          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
          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.