Skip to content

Commit b8b19af

Browse files
committed
fix note about whiptail vs dialog/cdialog is just fallback mode
* fix #23 the whiptail backend it exits but is not a supermode selectable, is used as fallback mode only when there is no dialog
1 parent e117cdc commit b8b19af

3 files changed

Lines changed: 38 additions & 7 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ transparently, based on the availability of the backends (frontends).
2222

2323
* Console mode:
2424
* dialog
25-
* whiptail
25+
* cdialog
2626
* Graphical mode:
2727
* yad
2828
* gtkdialog

docs/README.md

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,37 @@ EBG is fully modular, you create a new script and just sourcered the endpoint:
8585
* `easydialog-legacy` stand-alone to create dialog boxes externally (as old nowadays)
8686
* `easybashlib` used for for optional functions like cleaning temporally working dir
8787

88+
#### Backend Widget support
89+
90+
EBG implements differents dialogs boxes! You don't have to worry about what
91+
environment you are running the script in, as **EasyBashGUI** will handle this
92+
transparently, based on the availability of the widget backends (frontends).
93+
94+
* Console mode:
95+
* dialog
96+
* cdialog
97+
* whiptail (not selectable, just fallback)
98+
* Graphical mode:
99+
* yad
100+
* gtkdialog
101+
* kdialog
102+
* zenity
103+
* xdialog
104+
105+
If there is no dialog/cdialog support installed. Check next section about `supermode`!
106+
107+
#### The supermode for backend widget
108+
109+
The backends for frontends (the widgets to use to diaplay boxes) are selectable
110+
by the `supermode` environment variable.
111+
112+
The `supermode` environment variable its only used to force or manually select
113+
an especific widget , by example using `kdialog` under GTK desktop, or by example
114+
using `zenity` under KDE environment. Also when EBG fails to detect widget usage!
115+
116+
There is no `whiptail` mode because is used only as fallback! when dialog/cdialog
117+
is missing, simply just use `supermode=dialog` for!
118+
88119
### System wide usage vs module user usage
89120

90121
If EBG is not installed you should have at least all the files in the same path
@@ -831,9 +862,9 @@ notify [-c "<command>"] [-i "<icongood|iconbad>"] [-t "<textgood|textbad>"] "[go
831862

832863
## Notes
833864

834-
EasyBashGUI doesn't work with original "dialog" ( old one ) that is very limited; if you have first version "dialog" in your box, install "cdialog" and alias or link "dialog" to cdialog. No problem in case you have at least "whiptail" installed: since version 4.0.0, EasyBashGUI is able to use it instead of (c)dialog.
865+
EasyBashGUI doesn't work with original "dialog" ( old one ) that is very limited; if you have first version "dialog" in your box, install "cdialog" and alias or link "dialog" to cdialog.
835866

836-
Since 5.0.0 version you can use EasyBashGUI even if NO WIDGET is installed (that is: no gtkdialog, no kdialog, no zenity, no Xdialog, no (c)dialog, no whiptail... doh!!!!! ). To use "super bare" EBG, simply remove the ".lib" library from your path, or set "supermode" var to "none" before easybashgui sourcing (e.g.: >export supermode="none" && source easybashgui && message "Hello world..." )
867+
Since 5.0.0 version you can use EasyBashGUI even if NO WIDGET backend is installed (that is: no gtkdialog, no kdialog, no zenity, no Xdialog, no (c)dialog... doh!!!!! ). To use "super bare" EBG, simply remove the ".lib" library from your path, or set "supermode" var to "none" before easybashgui sourcing (e.g.: >export supermode="none" && source easybashgui && message "Hello world..." )
837868

838869
EasyBashGUI sets gtkdialog output statements as variables through "eval". This way, in theory, could be possibly dangerous; nevertheless, so far, I don't know about any alternative way...
839870

docs/install.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ Simplified way to code bash made GUI frontend dialogs! - Installation document!
77

88
* Dialog backend that will act as frontend gui:
99
* Console:
10-
* `dialog` 1.2-20120230+ https://invisible-island.net/dialog
11-
* `whiptail` 0.52+ https://pagure.io/newt
10+
* `cdialog` / `dialog` 1.2-20120230+ https://invisible-island.net/dialog (required)
11+
* `whiptail` 0.52+ https://pagure.io/newt used as falback, not selectable!
1212
* Graphical:
1313
* `yad` 0.20+ https://github.com/v1cont/yad (GTK2 branch available)
1414
* `gtkdialog` 0.8.3+ https://code.google.com/p/gtkdialog (limited support)
1515
* `kdialog` 1.0+ https://invent.kde.org/utilities/kdialog (was part of kdebin)
1616
* `zenity` 2.30+ https://wiki.gnome.org/Projects/Zenity (may work with 2.X)
17-
* `xdialog` 1.0+ http://xdialog.free.fr/
17+
* `xdialog` 1.0+ http://xdialog.free.fr/ (new support for https://wdlkmpx.github.io/Xdialog/ comming)
1818
* Interpreter runtime programs:
1919
* `coreutils` 8.0+ https://www.gnu.org/software/coreutils/
2020
* `bash` 3.0+ https://tiswww.case.edu/php/chet/bash/bashtop.html
@@ -91,7 +91,7 @@ like `wc`, `type`, `cut` and `bash` and we relies on their important features
9191
that `busybox` neither `dash`/`sh` can provide it!
9292
* **backends (frontends) are not dependencies, but (c)dialog it is!**, we are
9393
aware that we need a backend, but "dialog" is the backend that must be placed as
94-
a dependency, but since not only does "whiptail" depend on a library separate
94+
a dependency, but since not only, because "cdialog" its the best dependency you must.
9595
from its own but it has fewer functionalities in itself, "dialog" is by far
9696
compatible with everything created since the beginning of times.
9797
* **don't recommend any backend (frontend), it's not necessary!**, not so much

0 commit comments

Comments
 (0)