[gtk/matthiasc/for-master: 40/41] docs: Sync up debug flag information

[Matthias Clasen <matthiasc src gnome org>]

commit 40f292cb135f64260ddcb2d078eebef39b33cc6d
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat May 22 20:41:48 2021 -0400

    docs: Sync up debug flag information

 docs/reference/gtk/running.md | 30 ++++++++++++++++++------------
 gtk/gtkdebug.h                | 28 ++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 12 deletions(-)
---
diff --git a/docs/reference/gtk/running.md b/docs/reference/gtk/running.md
index bd798341d2..924c5b344f 100644
--- a/docs/reference/gtk/running.md
+++ b/docs/reference/gtk/running.md
@@ -22,20 +22,26 @@ are only available when GTK has been configured with `-Ddebug=true`.
 `builder`
 : GtkBuilder support
 
+`builder-objects`
+: Unused GtkBuilder objects
+
 `geometry`
 : Size allocation
 
 `icontheme`
 : Icon themes
 
+`iconfallback`
+: Information about icon fallback
+
 `keybindings`
-: Keybindings
+: Keyboard shortcuts
 
 `modules`
-: Loading of modules
+: Modules and extensions
 
 `printing`
-: Printing support
+: Printing
 
 `size-request`
 : Size requests
@@ -46,6 +52,15 @@ are only available when GTK has been configured with `-Ddebug=true`.
 `tree`
 : Tree widget internals
 
+`constraints`
+: Constraints and the constraint solver
+
+`layout`
+: Layout managers
+
+`acccessibility`
+: Accessibility state changs
+
 A number of keys are influencing behavior instead of just logging:
 
 `interactive`
@@ -57,15 +72,6 @@ A number of keys are influencing behavior instead of just logging:
 `touchscreen`
 : Pretend the pointer is a touchscreen device
 
-`updates`
-: Visual feedback about window updates
-
-`resize`
-: Highlight resizing widgets
-
-`layout`
-: Show layout borders
-
 `snapshot`
 : Include debug render nodes in the generated snapshots
 
diff --git a/gtk/gtkdebug.h b/gtk/gtkdebug.h
index 4a10c96cff..6bd9d98d00 100644
--- a/gtk/gtkdebug.h
+++ b/gtk/gtkdebug.h
@@ -34,6 +34,34 @@
 
 G_BEGIN_DECLS
 
+/**
+ * GtkDebugFlags:
+ * @GTK_DEBUG_TEXT: Information about GtkTextView
+ * @GTK_DEBUG_TREE: Information about GtkTreeView
+ * @GTK_DEBUG_KEYBINDINGS: Information about keyboard shortcuts
+ * @GTK_DEBUG_MODULES: Information about modules and extensions
+ * @GTK_DEBUG_GEOMETRY: Information about size allocation
+ * @GTK_DEBUG_ICONTHEME: Information about icon themes
+ * @GTK_DEBUG_PRINTING: Information about printing
+ * @GTK_DEBUG_BUILDER: Trace GtkBuilder operation
+ * @GTK_DEBUG_SIZE_REQUEST: Information about size requests
+ * @GTK_DEBUG_NO_CSS_CACHE: Disable the style property cache
+ * @GTK_DEBUG_INTERACTIVE: Open the GTK inspector
+ * @GTK_DEBUG_TOUCHSCREEN: Pretend the pointer is a touchscreen
+ * @GTK_DEBUG_ACTIONS: Information about actions and menu models
+ * @GTK_DEBUG_LAYOUT: Information from layout managers
+ * @GTK_DEBUG_SNAPSHOT: Include debug render nodes in the generated snapshots
+ * @GTK_DEBUG_CONSTRAINTS: Information from the constraints solver
+ * @GTK_DEBUG_BUILDER_OBJECTS: Log unused GtkBuilder objects
+ * @GTK_DEBUG_A11Y: Information about accessibility state changes
+ * @GTK_DEBUG_ICONFALLBACK: Information about icon fallback
+ *
+ * Flags to use with gtk_set_debug_flags().
+ *
+ * Settings these flags causes GTK to print out different
+ * types of debugging information. Some of these flags are
+ * only available when GTK has been configured with `-Ddebug=true`.
+ */
 typedef enum {
   GTK_DEBUG_TEXT            = 1 <<  0,
   GTK_DEBUG_TREE            = 1 <<  1,