diff --git a/gio/gactionmap.c b/gio/gactionmap.c
index bee2a8143..c5b3d2eb5 100644
--- a/gio/gactionmap.c
+++ b/gio/gactionmap.c
@@ -133,10 +133,11 @@ g_action_map_remove_action (GActionMap  *action_map,
  * @parameter_type: the type of the parameter that must be passed to the
  *                  activate function for this action, given as a single
  *                  GVariant type string (or %NULL for no parameter)
- * @state: the initial state for this action, given in GVariant text
- *         format.  The state is parsed with no extra type information,
- *         so type tags must be added to the string if they are
- *         necessary.  Stateless actions should give %NULL here.
+ * @state: the initial state for this action, given in
+ *         [GVariant text format][gvariant-text].  The state is parsed
+ *         with no extra type information, so type tags must be added to
+ *         the string if they are necessary.  Stateless actions should
+ *         give %NULL here.
  * @change_state: the callback to connect to the "change-state" signal
  *                of the action.  All stateful actions should provide a
  *                handler here; stateless actions should not.