From 4b25b43f8301aec03f594c6db04c91148d9f93ac Mon Sep 17 00:00:00 2001 From: =?utf8?q?Luk=C3=A1=C5=A1=20Tyrychtr?= Date: Mon, 20 Sep 2021 10:52:16 +0200 Subject: [PATCH] Mention that after setting a button child the user is responsible for a11y relations --- gtk/gtkbutton.c | 6 ++++++ 1 file changed, 6 insertions(+) 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, -- 2.30.2