xref: /dflybsd-src/contrib/dialog/README (revision b2dabe2e739bd72461a68ac543307c2dedfb048c)
15382d832SPeter Avalos-(1999-12-25)-------------------------------------------------------------------
25382d832SPeter AvalosThis version of dialog, formerly known as cdialog is based on the Debian
35382d832SPeter Avalospackage for dialog 0.9a (see CHANGES for recent modifications)
45382d832SPeter Avalos- T.Dickey <dickey@invisible-island.net>
55382d832SPeter Avalos
65382d832SPeter Avalos-(1996-01-15)-------------------------------------------------------------------
75382d832SPeter AvalosI have uploaded cdialog-0.9a.tar.gz to sunsite. It should be moved
85382d832SPeter Avalosto pub/Linux/utils/shell, I think.
95382d832SPeter Avalos
105382d832SPeter AvalosStarting point for cdialog v.0.9a was dialog-0.6c. Many new features
115382d832SPeter Avaloslike as Resolution-independence, Auto-sizing, Maximizing, more widget
125382d832SPeter Avaloson the same screen (multi-widget), etc. were added. New widget are
135382d832SPeter Avalostailbox and tailbox-in-background. Here are the options:
145382d832SPeter Avalos
155382d832SPeter Avalos   Usage: dialog <Common options> <Box options>
165382d832SPeter Avalos          { --and-widget <Common options> <Box options> }
175382d832SPeter Avalos
185382d832SPeter Avalos   Common options: <Global options>
195382d832SPeter Avalos       [--backtitle <backtitle>] [--sleep <secs>] [--beep] [--beep-after]
205382d832SPeter Avalos       [--clear] [--begin <y> <x>] [--aspect <ratio>] [--print-size]
215382d832SPeter Avalos       [--print-maxsize] [--size-err] [--separate-output] [--cr-wrap]
225382d832SPeter Avalos       [--tab-len <n>] [--tab-correct] [--print-version] [--no-kill]
235382d832SPeter Avalos       [--title <title>]
245382d832SPeter Avalos
255382d832SPeter Avalos   Global options: [--shadow] [--no-shadow] [--separate-widget "<str>"]
265382d832SPeter Avalos
275382d832SPeter AvalosAt the moment, mouse support with libgpm can't be added because it
285382d832SPeter Avalosdoes't implement the wtimeout() function of ncurses. Wtimeout() is
295382d832SPeter Avalosneeded to have more widgets (es.tailbox) cooperating on the same
305382d832SPeter Avalosscreen... I don't know if with newer versions of libgpm it's possible.
315382d832SPeter Avalos
325382d832SPeter AvalosI have no more time to write docs for this new version...Is there
335382d832SPeter Avalosanyone, that looking at the code, can do it??? Ouch! :-)
345382d832SPeter AvalosDon't flame me!
355382d832SPeter Avalos
365382d832SPeter AvalosFor the future, if any volunteer want, the way to evolve cdialog is to
375382d832SPeter Avalos1) make a daemon for a better support of multi-tasking or implementing
385382d832SPeter Avalos   multithreading.
395382d832SPeter Avalos2) add an option that could permit to read commands (--options) from a
405382d832SPeter Avalos   file, like as in a normal programming language, but maintaining
41*a8e38dc0SAntonio Huete Jimenez   compatibility with older version of dialog.
425382d832SPeter Avalos
435382d832SPeter AvalosI no longer could maintain cdialog...
445382d832SPeter AvalosExecutable and library name of cdialog are the same of dialog, for
45*a8e38dc0SAntonio Huete Jimenezcompatibility.
465382d832SPeter Avalos
475382d832SPeter AvalosI think that only one directive should be follow: don't use a resource
485382d832SPeter Avaloslike stdin, stdout when you'll write new options for cdialog; these
495382d832SPeter Avalosresources have to be shared from all widgets on the command line.
505382d832SPeter AvalosGuage uses stdin :-/ so that can't be mixed for example with an inputbox,
515382d832SPeter Avalosbut it was made before of multi-widget. However this is not a big problem!
525382d832SPeter Avalos
535382d832SPeter AvalosTHERE ARE NO *KNOWN* BUGS. If anyone has much time and can find the way
545382d832SPeter Avalosto add wtimeout() support to libgpm, also mouse could be supported.
555382d832SPeter Avalos
565382d832SPeter AvalosPlease use ncurses-1.9.4 or newer.
575382d832SPeter Avalos
585382d832SPeter Avalos|  __   |  demarco_p@abramo.it:~$ make Linux | more > UserFriendly;
595382d832SPeter Avalos| /__)  |  /~~  _   _ _   _   /~\  _     /  .  _          |
605382d832SPeter Avalos|/  ako | (___ (_) | ) ) (-' (__/ | )   /__ | | ) (_| ><  .  coordinator.
615382d832SPeter Avalos
62