From 424dd8a46392d87de36abb78d8b261c54193758a Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 16 Jun 2021 10:34:37 -0400 Subject: [PATCH] actionobserver: Clarify primary_accel_changed docs Either action_name or action_and_target may be NULL here, and observer implementations should be careful when checking those values. --- gtk/gtkactionobserver.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/gtk/gtkactionobserver.c b/gtk/gtkactionobserver.c index 77faa7fcb7..96791a9a27 100644 --- a/gtk/gtkactionobserver.c +++ b/gtk/gtkactionobserver.c @@ -158,15 +158,17 @@ gtk_action_observer_action_removed (GtkActionObserver *observer, * gtk_action_observer_primary_accel_changed: * @observer: a `GtkActionObserver` * @observable: the source of the event - * @action_name: the name of the action - * @action_and_target: detailed action of the changed accel, in “action and target” format + * @action_name: (nullable): the name of the action + * @action_and_target: (nullable): detailed action of the changed accel, in “action and target” format * * This function is called when an action that the observer is * registered to receive events for has one of its accelerators changed. * * Accelerator changes are reported for all targets associated with the - * action. The @action_and_target string should be used to check if the + * action. The @action_and_target string should be used to check if the * reported target is the one that the observer is interested in. + * + * Either @action_name or @action_and_target may be %NULL. */ void gtk_action_observer_primary_accel_changed (GtkActionObserver *observer,