[gtk/matthiasc/for-master] docs: Add css docs to entries



commit fd2861d683b82608d5f6639f314765de4626f335
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jun 26 11:56:27 2020 -0400

    docs: Add css docs to entries
    
    The various entries were missing the semi-standard
    "CSS Nodes" section in their long descriptions. Add
    them.

 gtk/gtkentry.c         |  2 +-
 gtk/gtkpasswordentry.c | 14 ++++++++++++++
 gtk/gtksearchentry.c   | 11 +++++++++++
 3 files changed, 26 insertions(+), 1 deletion(-)
---
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 6ab195c7c6..77d4241121 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -121,7 +121,7 @@
  * ├── text[.readonly]
  * ├── image.left
  * ├── image.right
- * ├── [progress[.pulse]]
+ * ╰── [progress[.pulse]]
  * ]|
  *
  * GtkEntry has a main node with the name entry. Depending on the properties
diff --git a/gtk/gtkpasswordentry.c b/gtk/gtkpasswordentry.c
index 391f5076ed..30e0950490 100644
--- a/gtk/gtkpasswordentry.c
+++ b/gtk/gtkpasswordentry.c
@@ -50,6 +50,20 @@
  *
  * GtkPasswordEntry provides only minimal API and should be used with the
  * #GtkEditable API.
+ *
+ * # CSS Nodes
+ *
+ * |[<!-- language="plain" -->
+ * entry.password
+ * ╰── text
+ *     ├── image.caps-lock-indicator
+ *     ┊
+ * ]|
+ *
+ * GtkPasswordEntry has a single CSS node with name entry that carries
+ * a .passwordstyle class. The text Css node below it has a child with
+ * name image and style class .caps-lock-indicator for the Caps Lock
+ * icon, and possibly other children.
  */
 
 typedef struct {
diff --git a/gtk/gtksearchentry.c b/gtk/gtksearchentry.c
index e65b3b7b85..4be02d57a7 100644
--- a/gtk/gtksearchentry.c
+++ b/gtk/gtksearchentry.c
@@ -71,6 +71,17 @@
  * placed inside a #GtkSearchBar. If that is not the case,
  * you can use gtk_search_entry_set_key_capture_widget() to let it
  * capture key input from another widget.
+ *
+ * # CSS Nodes
+ *
+ * |[<!-- language="plain" -->
+ * entry.search
+ * ╰── text
+ * ]|
+ *
+ * GtkSearchEntry has a single CSS node with name entry that carries
+ * a .sarch style class, and the text node is a child of that.
+
  */
 
 enum {


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]