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