From: Lukáš Tyrychtr <lukastyrychtr@gmail.com>
Date: Mon, 20 Sep 2021 08:52:16 +0000 (+0200)
Subject: Mention that after setting a button child the user is responsible for a11y relations
X-Git-Tag: archive/raspbian/4.6.5+ds-1+rpi1~1^2~19^2~5^2~320^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=da20c68d480c2d87de94e47200cf738cabb9e3ed;p=gtk4.git

Mention that after setting a button child the user is responsible for a11y relations
---

diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index 49f0681767..f02ca168bc 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -1035,6 +1035,12 @@ gtk_button_get_action_helper (GtkButton *button)
  * @child: (nullable): the child widget
  *
  * Sets the child widget of @button.
+ *
+ * Note that by using this API, you take full responsibility for setting
+ * up the proper accessibility label and description information for @button.
+ * Most likely, you'll either set the accessibility label or description
+ * for @button explicitly, or you'll set a labelled-by or described-by
+ * relations from @child to @button.
  */
 void
 gtk_button_set_child (GtkButton *button,