nckx pushed a commit to branch master
in repository guix.
commit c3e42621e9f6234ac674bc68dc500756ebd579dd
Author: Tobias Geerinckx-Rice <[email protected]>
AuthorDate: Sun Sep 29 02:00:00 2024 +0200
gnu: stfl: Expand description.
* gnu/packages/ncurses.scm (stfl)[description]: Expand it.
Change-Id: I850d773fcff2536f8a52d62cbf7c08fb7cfe4e6c
---
gnu/packages/ncurses.scm | 14 ++++++++++++--
1 file changed, 12 insertions(+), 2 deletions(-)
diff --git a/gnu/packages/ncurses.scm b/gnu/packages/ncurses.scm
index e82e6ebd54..b57ec56865 100644
--- a/gnu/packages/ncurses.scm
+++ b/gnu/packages/ncurses.scm
@@ -354,6 +354,16 @@ of your system.")
(home-page (string-append "https://web.archive.org/web/20211113222004/";
"http://www.clifford.at/stfl/";))
(synopsis "Structured terminal forms library")
- (description "Stfl is a library which implements a curses-based widget
-set for text terminals.")
+ (description "@acronym{STFL, Structured Terminal Forms Language} is a
+language for easily describing @acronym{GUIs, Graphical User Interfaces}.
+@acronym{STFL, Structured Terminal Forms Library} is also the name of this
+library which translates those descriptions into a curses-based widget set for
+text terminals.
+
+STFL descriptions do not contain any concrete layouting information, such as
x/y
+coordinates of widgets. Instead, container widgets such as vertical and
+horizontal boxes, as well as tables, are used to group widgets. The actual
+layouting work is done by the STFL library. This allows STFL GUIs to handle
+terminals of different sizes and terminal resize events transparently for the
+application programmer.")
(license lgpl3+)))
