diff --git a/gio/gaction.c b/gio/gaction.c
index e6b42da84..a3edec9d1 100644
--- a/gio/gaction.c
+++ b/gio/gaction.c
@@ -374,6 +374,8 @@ g_action_get_enabled (GAction *action)
  * the parameter type given at construction time).  If the parameter
  * type was %NULL then @parameter must also be %NULL.
  *
+ * If the @parameter GVariant is floating, it is consumed.
+ *
  * Since: 2.28
  **/
 void
diff --git a/gio/gsimpleaction.c b/gio/gsimpleaction.c
index 64dacfd99..49188ad0d 100644
--- a/gio/gsimpleaction.c
+++ b/gio/gsimpleaction.c
@@ -144,6 +144,8 @@ g_simple_action_change_state (GAction  *action,
  * property.  Instead, they should call g_action_change_state() to
  * request the change.
  *
+ * If the @value GVariant is floating, it is consumed.
+ *
  * Since: 2.30
  **/
 void