contrib/dialog/README

   1 -(1999-12-25)-------------------------------------------------------------------
   2 This version of dialog, formerly known as cdialog is based on the Debian
   3 package for dialog 0.9a (see CHANGES for recent modifications)
   4 - T.Dickey <dickey@invisible-island.net>
   5
   6 -(1996-01-15)-------------------------------------------------------------------
   7 I have uploaded cdialog-0.9a.tar.gz to sunsite. It should be moved
   8 to pub/Linux/utils/shell, I think.
   9
  10 Starting point for cdialog v.0.9a was dialog-0.6c. Many new features
  11 like as Resolution-independence, Auto-sizing, Maximizing, more widget
  12 on the same screen (multi-widget), etc. were added. New widget are
  13 tailbox and tailbox-in-background. Here are the options:
  14
  15    Usage: dialog <Common options> <Box options>
  16           { --and-widget <Common options> <Box options> }
  17
  18    Common options: <Global options>
  19        [--backtitle <backtitle>] [--sleep <secs>] [--beep] [--beep-after]
  20        [--clear] [--begin <y> <x>] [--aspect <ratio>] [--print-size]
  21        [--print-maxsize] [--size-err] [--separate-output] [--cr-wrap]
  22        [--tab-len <n>] [--tab-correct] [--print-version] [--no-kill]
  23        [--title <title>]
  24
  25    Global options: [--shadow] [--no-shadow] [--separate-widget "<str>"]
  26
  27 At the moment, mouse support with libgpm can't be added because it
  28 does't implement the wtimeout() function of ncurses. Wtimeout() is
  29 needed to have more widgets (es.tailbox) cooperating on the same
  30 screen... I don't know if with newer versions of libgpm it's possible.
  31
  32 I have no more time to write docs for this new version...Is there
  33 anyone, that looking at the code, can do it??? Ouch! :-)
  34 Don't flame me!
  35
  36 For the future, if any volunteer want, the way to evolve cdialog is to
  37 1) make a daemon for a better support of multi-tasking or implementing
  38    multithreading.
  39 2) add an option that could permit to read commands (--options) from a
  40    file, like as in a normal programming language, but maintaining
  41    compatiblity with older version of dialog.
  42
  43 I no longer could maintain cdialog...
  44 Executable and library name of cdialog are the same of dialog, for
  45 compatiblity.
  46
  47 I think that only one directive should be follow: don't use a resource
  48 like stdin, stdout when you'll write new options for cdialog; these
  49 resources have to be shared from all widgets on the command line.
  50 Guage uses stdin :-/ so that can't be mixed for example with an inputbox,
  51 but it was made before of multi-widget. However this is not a big problem!
  52
  53 THERE ARE NO *KNOWN* BUGS. If anyone has much time and can find the way
  54 to add wtimeout() support to libgpm, also mouse could be supported.
  55
  56 Please use ncurses-1.9.4 or newer.
  57
  58 |  __   |  demarco_p@abramo.it:~$ make Linux | more > UserFriendly;
  59 | /__)  |  /~~  _   _ _   _   /~\  _     /  .  _          |
  60 |/  ako | (___ (_) | ) ) (-' (__/ | )   /__ | | ) (_| ><  .  coordinator.
  61