X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gio%2Fgactionmap.c;h=c5b3d2eb516a65f7b7430e799130fbb34db94e3c;hb=2a53b4d0e2c98a14aedf31e38f0ad1fb2e8fe26f;hp=bd422246d155dc9a799a283ed5250e3359956819;hpb=38720494452aa336eb2f168ac4bd2add138c400e;p=platform%2Fupstream%2Fglib.git
diff --git a/gio/gactionmap.c b/gio/gactionmap.c
index bd42224..c5b3d2e 100644
--- a/gio/gactionmap.c
+++ b/gio/gactionmap.c
@@ -12,9 +12,7 @@
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
- * Public License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Public License along with this library; if not, see .
*
* Authors: Ryan Lortie
*/
@@ -126,16 +124,23 @@ g_action_map_remove_action (GActionMap *action_map,
* GActionEntry:
* @name: the name of the action
* @activate: the callback to connect to the "activate" signal of the
- * action
+ * action. Since GLib 2.40, this can be %NULL for stateful
+ * actions, in which case the default handler is used. For
+ * boolean-stated actions with no parameter, this is a
+ * toggle. For other state types (and parameter type equal
+ * to the state type) this will be a function that
+ * just calls @change_state (which you should provide).
* @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.
+ * @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
+ * of the action. All stateful actions should provide a
+ * handler here; stateless actions should not.
*
* This struct defines a single action. It is for use with
* g_action_map_add_action_entries().
@@ -162,9 +167,7 @@ g_action_map_remove_action (GActionMap *action_map,
*
* Each action is constructed as per one #GActionEntry.
*
- *
- * Using g_action_map_add_action_entries()
- *
+ * |[
* static void
* activate_quit (GSimpleAction *simple,
* GVariant *parameter,
@@ -195,8 +198,7 @@ g_action_map_remove_action (GActionMap *action_map,
*
* return G_ACTION_GROUP (group);
* }
- *
- *
+ * ]|
*
* Since: 2.32
*/