luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-05-17 03:01:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

GSimpleAction: Explain "(expected|correct) type"

Browse Source 
Let's avoid users having to infer what these mean; it's easy to explain.

https://bugzilla.gnome.org/show_bug.cgi?id=795070
This commit is contained in:
Daniel Boles 2018-04-08 11:40:06 +01:00
parent 75021c6c6e
commit 21348867fe
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
gio/gsimpleaction.c
View File

@ -376,8 +376,9 @@ g_simple_action_class_init (GSimpleActionClass *class)
* *
* Indicates that the action was just activated. * Indicates that the action was just activated.
* *
* @parameter will always be of the expected type. In the event that * @parameter will always be of the expected type, i.e. the parameter type
* an incorrect type was given, no signal will be emitted. * specified when the action was created. If an incorrect type is given when
* activating the action, this signal is not emitted.
* *
* Since GLib 2.40, if no handler is connected to this signal then the * Since GLib 2.40, if no handler is connected to this signal then the
* default behaviour for boolean-stated actions with a %NULL parameter * default behaviour for boolean-stated actions with a %NULL parameter
@ -406,8 +407,10 @@ g_simple_action_class_init (GSimpleActionClass *class)
* Indicates that the action just received a request to change its * Indicates that the action just received a request to change its
* state. * state.
* *
* @value will always be of the correct state type. In the event that * @value will always be of the correct state type, i.e. the type of the
* an incorrect type was given, no signal will be emitted. * initial state passed to g_simple_action_new_stateful(). If an incorrect
* type is given when requesting to change the state, this signal is not
* emitted.
* *
* If no handler is connected to this signal then the default * If no handler is connected to this signal then the default
* behaviour is to call g_simple_action_set_state() to set the state * behaviour is to call g_simple_action_set_state() to set the state