aboutsummaryrefslogtreecommitdiff
path: root/contrib/bsddialog/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/bsddialog/README.md')
-rw-r--r--contrib/bsddialog/README.md56
1 files changed, 35 insertions, 21 deletions
diff --git a/contrib/bsddialog/README.md b/contrib/bsddialog/README.md
index 3a814b38ddb4..f4846ec07745 100644
--- a/contrib/bsddialog/README.md
+++ b/contrib/bsddialog/README.md
@@ -1,28 +1,17 @@
-# BSDDialog 0.2
+# BSDDialog 1.0
+This project provides **bsddialog** and **libbsddialog**, an utility
+and a library to build scripts and tools with TUI dialogs and widgets.
-This project provides **bsddialog** and **libbsddialog**, an utility and a
-library to build scripts and tools with TUI dialogs and widgets.
+## Demo
-## Intro
-
-Briefly:
-<https://www.freebsd.org/status/report-2021-04-2021-06/#_bsddialog_tui_widgets>
-
-Utility:
-<https://alfonsosiciliano.gitlab.io/posts/2021-12-07-bsddialog.html>
-
-Library:
-<https://alfonsosiciliano.gitlab.io/posts/2022-01-16-libbsddialog.html>
-
-Screenshots:
-<https://www.flickr.com/photos/alfonsosiciliano/albums/72157720215006074>
+[Screenshots](https://www.flickr.com/photos/alfonsosiciliano/albums/72157720215006074).
## Getting Started
-FreeBSD:
+FreeBSD and Linux:
```
% git clone https://gitlab.com/alfix/bsddialog.git
@@ -40,9 +29,9 @@ Output:
**Dialogs:**
---checklist, --datebox, --form, --gauge, --inputbox, --menu, --mixedform,
---mixedgauge, --msgbox, --passwordbox, --passwordform, --pause, --radiolist,
---rangebox, --textbox, --timebox, --treeview, --yesno.
+--calendar, --checklist, --datebox, --form, --gauge, --infobox, --inputbox,
+--menu, --mixedform, --mixedgauge, --msgbox, --passwordbox, --passwordform,
+--pause, --radiolist, --rangebox, --textbox, --timebox, --treeview, --yesno.
**Manual**
@@ -64,7 +53,9 @@ Output:
and [Examples](https://gitlab.com/alfix/bsddialog/-/tree/main/examples_utility)
in the _Public Domain_ to build new projects:
```
+% sh ./examples_utility/calendar.sh
% sh ./examples_utility/checklist.sh
+% sh ./examples_utility/datebox.sh
% sh ./examples_utility/form.sh
% sh ./examples_utility/gauge.sh
% sh ./examples_utility/infobox.sh
@@ -77,6 +68,7 @@ in the _Public Domain_ to build new projects:
% sh ./examples_utility/passwordform.sh
% sh ./examples_utility/pause.sh
% sh ./examples_utility/radiolist.sh
+% sh ./examples_utility/rangebox.sh
% sh ./examples_utility/timebox.sh
% sh ./examples_utility/yesno.sh
```
@@ -101,10 +93,14 @@ in the _Public Domain_ to build new projects:
```
% cd examples_library
% sh compile
+% ./calendar
+% ./checklist
% ./datebox
% ./form
+% ./gauge
% ./infobox
% ./menu
+% ./mixedgauge
% ./mixedlist
% ./msgbox
% ./pause
@@ -114,4 +110,22 @@ in the _Public Domain_ to build new projects:
% ./timebox
% ./yesno
```
-
+
+
+## TODO and Ideas
+
+ - menubar feature
+ - key callback
+ - Right-To-Left text
+ - some terminal does not hide the cursor, move it bottom-right before to getch.
+ - refactor backtitle: multiline, conf.backtitle, WINDOW \*dialog.backtitle.
+ - refactor bottomdesc: WINDOW \*dialog.bottomdesc -> fix expandig screen.
+ - accessibility https://wiki.freebsd.org/Accessibility/Wishlist/Base
+ - add bool conf.menu.depthlines.
+ - implement custom getopt\_long().
+ - refactor/redesign gauge().
+ - improve grey lines expanding terminal (maybe redrawwin() in hide\_dialog()).
+ - more restrictive strtol() and strtoul().
+ - implement global buttons handler.
+ - add/move external tutorial.
+ - implement menutype.min_on.