From: Pablo Correa Gómez <ablocorrea@hotmail.com>
Date: Tue, 13 Dec 2022 22:58:55 +0000 (+0100)
Subject: gtkcheckbutton: Document how to keep track of changes for radio buttons
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~9^2~30^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=42ba97eb5c6bc4f379487e166c9501c65174ca41;p=gtk4.git

gtkcheckbutton: Document how to keep track of changes for radio buttons
---

diff --git a/gtk/gtkcheckbutton.c b/gtk/gtkcheckbutton.c
index f0cc8ea6ff..4dec0530ce 100644
--- a/gtk/gtkcheckbutton.c
+++ b/gtk/gtkcheckbutton.c
@@ -77,6 +77,11 @@
  *
  * To add a `GtkCheckButton` to a group, use [method@Gtk.CheckButton.set_group].
  *
+ * When the code must keep track of the state of a group of radio buttons, it
+ * is recommended to keep track of such state through a stateful
+ * `GAction` with a target for each button. Using the `toggled` signals to keep
+ * track of the group changes and state is discouraged.
+ *
  * # CSS nodes
  *
  * ```