[gtk/wip/chergert/builder-expose-object-fix] gtkbuilder: update gtk_builder_expose_object() docs




commit d00d1334ce8c4d71360b35703984cb624a723354
Author: Christian Hergert <chergert redhat com>
Date:   Sun Jul 31 21:21:13 2022 -0700

    gtkbuilder: update gtk_builder_expose_object() docs

 gtk/gtkbuilder.c | 5 +++++
 1 file changed, 5 insertions(+)
---
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index f436bdc4bc..8b7ce86eda 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -1780,6 +1780,11 @@ gtk_builder_get_translation_domain (GtkBuilder *builder)
  *
  * Add @object to the @builder object pool so it can be
  * referenced just like any other object built by builder.
+ *
+ * Only a single object may be added using @name. However,
+ * it is not an error to expose the same object under multiple
+ * names. `gtk_builder_get_object()` may be used to determine
+ * if an object has already been added with @name.
  */
 void
 gtk_builder_expose_object (GtkBuilder    *builder,


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