GSimpleAction: Slightly improve docs for new()s

Explain why we say "See new_stateful()" (although it's pretty obvious).
Drop a redundant copy of the argument description in the body text.
Add a # to the GVariant type name so that we can have a nice link.

https://bugzilla.gnome.org/show_bug.cgi?id=795070
This commit is contained in:
Daniel Boles 2018-04-08 11:41:17 +01:00
parent 21348867fe
commit ff0c30b516

View File

@ -600,7 +600,8 @@ g_simple_action_set_state_hint (GSimpleAction *simple,
*
* Creates a new action.
*
* The created action is stateless. See g_simple_action_new_stateful().
* The created action is stateless. See g_simple_action_new_stateful() to create
* an action that has state.
*
* Returns: a new #GSimpleAction
*
@ -627,10 +628,10 @@ g_simple_action_new (const gchar *name,
*
* Creates a new stateful action.
*
* @state is the initial state of the action. All future state values
* must have the same #GVariantType as the initial state.
* All future state values must have the same #GVariantType as the initial
* @state.
*
* If the @state GVariant is floating, it is consumed.
* If the @state #GVariant is floating, it is consumed.
*
* Returns: a new #GSimpleAction
*