gtkbuilder: update gtk_builder_expose_object() docs
authorChristian Hergert <chergert@redhat.com>
Mon, 1 Aug 2022 04:21:13 +0000 (21:21 -0700)
committerChristian Hergert <chergert@redhat.com>
Mon, 1 Aug 2022 04:37:20 +0000 (21:37 -0700)
gtk/gtkbuilder.c

index f436bdc4bc3dcb764efcb70edff2f4413a6f1eb0..8b7ce86edab17b1a8c21dc20f1c24f439f469391 100644 (file)
@@ -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,