From: Christian Hergert <chergert@redhat.com>
Date: Mon, 1 Aug 2022 04:21:13 +0000 (-0700)
Subject: gtkbuilder: update gtk_builder_expose_object() docs
X-Git-Tag: archive/raspbian/4.8.3+ds-2+rpi1~3^2~20^2~4^2~27^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=d00d1334ce8c4d71360b35703984cb624a723354;p=gtk4.git

gtkbuilder: update gtk_builder_expose_object() docs
---

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,