From b3ae172c1ead9b18642b00895313e56cb4d222ca Mon Sep 17 00:00:00 2001
From: Maximiliano Sandoval <msandova@gnome.org>
Date: Sat, 25 May 2024 18:05:41 +0200
Subject: [PATCH] gtk: Document error quark functions

---
 gtk/css/gtkcsserror.c     | 14 ++++++++++++++
 gtk/gtkbuilder.c          |  7 +++++++
 gtk/gtkconstraintlayout.c |  7 +++++++
 gtk/gtkdialogerror.c      |  8 ++++++++
 gtk/gtkicontheme.c        |  8 +++++++-
 gtk/gtkrecentmanager.c    |  7 +++++++
 6 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/gtk/css/gtkcsserror.c b/gtk/css/gtkcsserror.c
index 82428cdf0a..de93563727 100644
--- a/gtk/css/gtkcsserror.c
+++ b/gtk/css/gtkcsserror.c
@@ -21,12 +21,26 @@
 
 #include "gtkcsserror.h"
 
+/**
+ * gtk_css_parser_error_quark:
+ *
+ * Registers an error quark for CSS parsing errors.
+ *
+ * Returns: the error quark
+ **/
 GQuark
 gtk_css_parser_error_quark (void)
 {
   return g_quark_from_static_string ("gtk-css-parser-error-quark");
 }
 
+/**
+ * gtk_css_parser_warning_quark:
+ *
+ * Registers an error quark for CSS parsing warnings.
+ *
+ * Returns: the warning quark
+ **/
 GQuark
 gtk_css_parser_warning_quark (void)
 {
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index 840edf8827..9429037bff 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -2953,6 +2953,13 @@ gtk_builder_get_type_from_name (GtkBuilder  *builder,
   return type;
 }
 
+/**
+ * gtk_builder_error_quark:
+ *
+ * Registers an error quark for [class@Gtk.Builder] errors.
+ *
+ * Returns: the error quark
+ **/
 GQuark
 gtk_builder_error_quark (void)
 {
diff --git a/gtk/gtkconstraintlayout.c b/gtk/gtkconstraintlayout.c
index 0c22d94c23..a185d1b46b 100644
--- a/gtk/gtkconstraintlayout.c
+++ b/gtk/gtkconstraintlayout.c
@@ -1924,6 +1924,13 @@ attribute_from_name (const char *name)
   return GTK_CONSTRAINT_ATTRIBUTE_NONE;
 }
 
+/**
+ * gtk_constraint_vfl_parser_error_quark:
+ *
+ * Registers an error quark for VFL error parsing.
+ *
+ * Returns: the error quark
+ **/
 GQuark
 gtk_constraint_vfl_parser_error_quark (void)
 {
diff --git a/gtk/gtkdialogerror.c b/gtk/gtkdialogerror.c
index a968c68b65..8c15169901 100644
--- a/gtk/gtkdialogerror.c
+++ b/gtk/gtkdialogerror.c
@@ -20,6 +20,14 @@
 
 #include "gtk/gtkdialogerror.h"
 
+/**
+ * gtk_dialog_error_quark:
+ *
+ * Registers an error quark for an operation that requires a dialog if
+ * necessary.
+ *
+ * Returns: the error quark
+ */
 GQuark
 gtk_dialog_error_quark (void)
 {
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 652ade27f1..a51376cbe6 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -2526,7 +2526,13 @@ gtk_icon_theme_lookup_icon (GtkIconTheme       *self,
   return icon;
 }
 
-/* Error quark */
+/**
+ * gtk_icon_theme_error_quark:
+ *
+ * Registers an error quark for [class@Gtk.IconTheme] errors.
+ *
+ * Returns: the error quark
+ **/
 GQuark
 gtk_icon_theme_error_quark (void)
 {
diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c
index b093bfd58f..af42e229b7 100644
--- a/gtk/gtkrecentmanager.c
+++ b/gtk/gtkrecentmanager.c
@@ -243,6 +243,13 @@ has_case_prefix (const char *haystack,
   return *n == '\0';
 }
 
+/**
+ * gtk_recent_manager_error_quark:
+ *
+ * Registers an error quark for [class@RecentManager] errors.
+ *
+ * Returns: the error quark
+ **/
 GQuark
 gtk_recent_manager_error_quark (void)
 {