From 1dc20eda2885a2bf8ddbc93ebd2986eb2e5d44a2 Mon Sep 17 00:00:00 2001
From: Maximiliano Sandoval <msandova@gnome.org>
Date: Sat, 25 May 2024 18:16:08 +0200
Subject: [PATCH] gtk: Document constants

---
 gtk/gtkimcontextsimple.h | 7 +++++++
 gtk/gtkimmodule.h        | 5 +++++
 gtk/gtkmediafile.h       | 5 +++++
 3 files changed, 17 insertions(+)

diff --git a/gtk/gtkimcontextsimple.h b/gtk/gtkimcontextsimple.h
index 3fe3089a4c..28aefae216 100644
--- a/gtk/gtkimcontextsimple.h
+++ b/gtk/gtkimcontextsimple.h
@@ -30,6 +30,13 @@ G_BEGIN_DECLS
  * No longer used by GTK, just left here on the off chance that some
  * 3rd party code used this define.
  */
+/**
+ * GTK_MAX_COMPOSE_LEN:
+ *
+ * Evaluates to the maximum length of a compose sequence.
+ *
+ * This macro is longer used by GTK.
+ */
 #define GTK_MAX_COMPOSE_LEN 7
 
 #define GTK_TYPE_IM_CONTEXT_SIMPLE              (gtk_im_context_simple_get_type ())
diff --git a/gtk/gtkimmodule.h b/gtk/gtkimmodule.h
index 5506412fd5..73dc8e393a 100644
--- a/gtk/gtkimmodule.h
+++ b/gtk/gtkimmodule.h
@@ -21,6 +21,11 @@
 
 G_BEGIN_DECLS
 
+/**
+ * GTK_IM_MODULE_EXTENSION_POINT_NAME:
+ *
+ * The default name of the extension point.
+ */
 #define GTK_IM_MODULE_EXTENSION_POINT_NAME "gtk-im-module"
 
 G_END_DECLS
diff --git a/gtk/gtkmediafile.h b/gtk/gtkmediafile.h
index 9bff52ce7e..dc84ac3657 100644
--- a/gtk/gtkmediafile.h
+++ b/gtk/gtkmediafile.h
@@ -27,6 +27,11 @@
 
 G_BEGIN_DECLS
 
+/**
+ * GTK_MEDIA_FILE_EXTENSION_POINT_NAME:
+ *
+ * The default extension point name for media file.
+ */
 #define GTK_MEDIA_FILE_EXTENSION_POINT_NAME "gtk-media-file"
 
 #define GTK_TYPE_MEDIA_FILE             (gtk_media_file_get_type ())