This Xdialog written by Cyberone Internet.

Xdialog is designed to be a drop in replacement for the cdialog program.
It converts any terminal based program into a program with an X-windows
interface. The dialogs are easier to see and use and the treeview adds an
extra dimension to the way menus can be displayed.

If you have any problems/bugs contact alfred@cyberone.com.au and I will
try to help.

Please read the INSTALL file for installation instructions. 


Commands - 
Xdialog functions exactly as cdialog does, and it accepts the same command
line parameters. It also has an added treeview mode which can be very
handy.

Here is the command line arguments it accepts:

Usage: Xdialog <Common options> <Box options>

Common options:
       [--backtitle <backtitle>]    - the menubar title
       [--title <title>]            - Another part of the title 
       [--password ]                - make input to the screen '*' (ala
password entry screens)

Box options:
  --yesno     <text> <height> <width>
  --msgbox    <text> <height> <width>
  --infobox   <text> <height> <width>
  --inputbox  <text> <height> <width> [<init>]
  --textbox   <file> <height> <width>
  --menu      <text> <height> <width> <menu height> <tag1> <item1>...
  --checklist <text> <height> <width> <list height> <tag1> <item1> <status1>...
  --radiolist <text> <height> <width> <list height> <tag1> <item1> <status1>...
  --treeview  <text> <height> <width> <list height> <tag1> <item1> <status1> <item_depth1>...
  --guage     <text> <height> <width> <percent>
  --tailbox   <file> <height> <width>
  --tailboxbg <file> <height> <width>       
 

The only thing of note here is the treeview depth. This is the number of
levels in the tree entry should be, and it should *never* increase by more
than 1 at a time (decreasing by more than 1 is fine).

-------------------------------------------------------------------------------------
Xdialog v1.2.0, 14/04/00: Bug fixes and improvements by Thierry Godefroy
<xdialog@free.fr> (web site: http://xdialog.free.fr):

1.- Bug fixes:
    ~~~~~~~~~
- The <height> and <width> parameters are now actually taken into account.
  They must be specified in "lines" (12 pixels high each) and "characters"
  (8 pixels wide each). The 8x12 character size may be changed at compile
  time only by defining XSIZE_MULT and/or YSIZE_MULT in the CPPFLAGS line
  of the src/Makefile (e.g. CPPFLAGS = -DXSIZE_MULT=10 -DYSIZE_MULT=18).

- The <text> is now actually displayed by checklist, radiolist, menu, etc...

- The treeview options is debugged and now takes parameters in the order
  in which they are documented (it used to mess up the tags, the status
  and the item names). Note that the "<status>" ("on" or "off") is still
  not taken into account.

- The <tag>s are now displayed before the <item>s in checklist and radiolist
  (same behaviour as with "(c)dialog"). But as hidding them may be useful
  too, I added the transient "--no-tags" option (this option was also
  supposed to hide the tags with "--menu" but it looks like there is a bug
  in GTK preventing to do so; the option is therefore ignored by "--menu").

2.- Changes and improvements:
    ~~~~~~~~~~~~~~~~~~~~~~~~
- It is now possible to chain dialogs in a single Xdialog command line.
  The chain is broken as soon as a "cancel" button is pressed (see the
  "chain" example script in the "samples" directory).
  Note though that in this case no parameter can be defaulted in the
  <Box options>.

- Distinction has been made between "common options" (that will affect
  all the following "box options" until the same or opposite "common
  options" are encountered in the command line) and "transient options"
  that only apply to the next "box option" in the command line. The
  "--passwd" option has been made a "transient option".

- The <list/menu height> parameter (which was ignored by Xdialog v1.0) has
  been replaced by the <number of items> parameter for the "menu", "radiolist",
  "checklist" and "treeview" widgets. This differs from the (c)dialog syntax
  because in (c)dialog the <list height> parameter allows to set the list/menu
  height in the displayed menu (I don't think this is possible with GTK as the
  window can be resized at any size).  With Xdialog, this parameter gives the
  number of items in the list/menu (this allows to include a list/menu box
  option in a chained box options command line).

- The infobox now accepts an optional <timeout> parameter (the default is
  1000 and will make the infobox to vanish after one second) and no more
  waits forever for the "OK" button to be pressed (this makes infobox
  behave much more closer to the "(c)dialog" infobox).
  When timeout is set to 0, then infobox behaves differently:
   - The "OK" button is replaced by a "Cancel" buttton (unless the
     --no-button option is given, in which case no button will be set up).
   - It accepts messages from stdin (much in the same way as the gauge
     widget). These messages may be "XXXX" (in which case the infobox is
     closed) or new titles enclosed by "XXX" markers; as for the gauge
     widget, newlines can be inserted into the title (see below).
   - It waits until the "Cancel" button is pressed, or the "XXXX" message
     is received, or the stdin put at EOF.

- The "guage" widget has been properly renamed into "gauge". It does now
  behave much like the dialog gauge (it accepts percentage values on stdin
  as well as new titles enclosed by two "XXX" markers; a newline can be
  inserted into the new titles by isuing echo "//n" between each line).
  Note that the <percent> parameter (which represents the initial gauge
  position) is now optional and defaults to 0.

- The tailbox now also accepts stdin as an input file (replacing the
  <file> argument with a minus "-" sign), which allows to pipe data
  to the tailbox. Also, the menu is displayed as soon as Xdialog is
  invoked (it used to appear only once 1024 characters were read from
  the input file).

- A new "--fselect" box option is implemented (GTK file selector). Using
  the "--no-button" transient option with "--fselect" prevents the "New
  directory", "Delete" and "Rename" buttons to be displayed in the file
  selector.

- "--left", "--right", "--center", "--wrap" and "--no-wrap" common
  options have been added so to instruct Xdialog to justify the text
  left, right or centered and/or to wrap (or not) long lines (line
  wrapping also apply to the "back-title" line). Default is --center
  --no-wrap.

- "--screen-center" (default), "--under-mouse" and "--auto-placement"
  common options added so to control the Xdialog widgets placement.

- If the back-title line is empty (no --backtitle option in the command
  line), then it will not be displayed (Xdialog v1.0 used to display a
  "Cyberone -" line in this case).

- "--no-cancel" and "--no-button" options added. The "--no-cancel" option
  allows to suppress the "Cancel" button from the inputbox, textbox, menu,
  checklist, radiolist, treeview and tailbox(bg) widgets. The "--no-button"
  option allows to suppress all the "OK", the "Cancel" and the "Help"
  buttons from the tailbox(bg) and infobox menus as well as the "New
  directory", "Delete" and "Rename" buttons from the fselect box. Note that
  these options are transient ones and only apply to the next <Box option>
  listed in the command line.

- A new "--help" transient option has been added. This option is to be
  followed by the help text that will be displayed (in a msgbox) when the
  "Help" button is chosen. All widgets but the "gauge" and "fselect" ones
  got the help feature implemented. The <help> text following "--help" may
  hold "\n" (as for the <text> parameter) so to force help text line splitting.

- When the Xdialog window is closed via the window manager, a cancel event
  is now returned (i.e. the exit code is 1).

- Xdialog can now be compiled so to use french buttons labels (by adding
  -DFRENCH to the CPPFLAGS line of src/Makefile).

3.- Distribution changes:
    ~~~~~~~~~~~~~~~~~~~~
- Examples of how to use Xdialog are given into the "samples" directory
  (most of these examples are adapted from the "cdialog" ones).


The new usage for Xdialog v1.2.0 is therefore:

Usage: Xdialog <Common options> <Transient options> <Box options>

Common options:
       [--backtitle <backtitle>]
       [--title <title>]
       [--screen-center | --under-mouse | --auto-placement]
       [--center | --right | --left]
       [--no-wrap | --wrap]

Transient options:
       [--password]
       [--no-cancel]
       [--no-button]
       [--no-tags]
       [--help <help>]

Box options:
  --yesno     <text> <height> <width>
  --msgbox    <text> <height> <width>
  --infobox   <text> <height> <width> [<timeout>]
  --inputbox  <text> <height> <width> [<init>]
  --textbox   <file> <height> <width>
  --menu      <text> <height> <width> <number of items> <tag1> <item1>...
  --checklist <text> <height> <width> <number of items> <tag1> <item1> <status1>...
  --radiolist <text> <height> <width> <number of items> <tag1> <item1> <status1>...
  --treeview  <text> <height> <width> <number of items> <tag1> <item1> <status1> <item_depth1>...
  --gauge     <text> <height> <width> [<percent>]
  --tailbox   <file> <height> <width>
  --tailboxbg <file> <height> <width>
  --fselect   <file> <height> <width>
