[gtk/matthiasc/for-master: 7/14] actionobserver: Clarify primary_accel_changed docs

[Matthias Clasen <matthiasc src gnome org>]

commit 424dd8a46392d87de36abb78d8b261c54193758a
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Jun 16 10:34:37 2021 -0400

    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,