--- a/svghmi/widget_list.ysl2	Mon Sep 13 22:23:14 2021 +0200
+++ b/svghmi/widget_list.ysl2	Mon Sep 20 15:42:17 2021 +0200
@@ -1,6 +1,22 @@
 // widget_list.ysl2
+
 widget_desc("List") {
-    // TODO
+    longdesc
+    ||
+    List widget is a svg:group, list items are labeled elements
+    in that group.
+
+    To use a List, clone (svg:use) one of the items inside the widget that
+    expects a List.
+
+    Positions of items are relative to each other, and they must all be in the
+    same place. In order to make editing easier it is therefore recommanded to
+    make stacked clones of svg elements spread nearby the list.
+    ||
+
+    shortdesc > A named list of named graphical elements
+
+    arg name="listname"
 }
 
 widget_defs("List") {
@@ -11,15 +27,3 @@
     |     },
 }
 
-widget_defs("TextStyleList") {
-    // TODO
-}
-
-widget_defs("TextStyleList") {
-    |     styles: {
-    foreach "$hmi_element/*[@inkscape:label]" {
-        const "style", "func:refered_elements(.)[self::svg:text]/@style";
-    |         «@inkscape:label»: "«$style»",
-    }
-    |     },
-}