Undoccommentify action muxer files

This commit is contained in:
Matthias Clasen
2011-12-01 06:30:10 -05:00
committed by Ryan Lortie
parent 0683f086bb
commit bd30a1c556
3 changed files with 21 additions and 47 deletions

View File

@ -28,7 +28,7 @@
#include <string.h> #include <string.h>
/** /*
* SECTION:gactionmuxer * SECTION:gactionmuxer
* @short_description: Aggregate and monitor several action groups * @short_description: Aggregate and monitor several action groups
* *
@ -54,9 +54,7 @@
* This class is typically only used at the site of "consumption" of * This class is typically only used at the site of "consumption" of
* actions (eg: when displaying a menu that contains many actions on * actions (eg: when displaying a menu that contains many actions on
* different objects). * different objects).
* */
* Since: 2.32
**/
static void g_action_muxer_group_iface_init (GActionGroupInterface *iface); static void g_action_muxer_group_iface_init (GActionGroupInterface *iface);
static void g_action_muxer_observable_iface_init (GActionObservableInterface *iface); static void g_action_muxer_observable_iface_init (GActionObservableInterface *iface);
@ -145,8 +143,6 @@ g_action_muxer_action_enabled_changed (GActionGroup *action_group,
Action *action; Action *action;
GSList *node; GSList *node;
g_print ("feeling changes\n");
action = g_action_muxer_lookup_action (group->muxer, group->prefix, action_name, &fullname); action = g_action_muxer_lookup_action (group->muxer, group->prefix, action_name, &fullname);
for (node = action ? action->watchers : NULL; node; node = node->next) for (node = action ? action->watchers : NULL; node; node = node->next)
g_action_observer_action_enabled_changed (node->data, G_ACTION_OBSERVABLE (group->muxer), fullname, enabled); g_action_observer_action_enabled_changed (node->data, G_ACTION_OBSERVABLE (group->muxer), fullname, enabled);
@ -395,7 +391,7 @@ g_action_muxer_class_init (GObjectClass *class)
class->finalize = g_action_muxer_finalize; class->finalize = g_action_muxer_finalize;
} }
/** /*
* g_action_muxer_insert: * g_action_muxer_insert:
* @muxer: a #GActionMuxer * @muxer: a #GActionMuxer
* @prefix: the prefix string for the action group * @prefix: the prefix string for the action group
@ -414,9 +410,7 @@ g_action_muxer_class_init (GObjectClass *class)
* "action_added" notifications will be emitted, as appropriate. * "action_added" notifications will be emitted, as appropriate.
* *
* @prefix must not contain a dot ('.'). * @prefix must not contain a dot ('.').
* */
* Since: 2.32
**/
void void
g_action_muxer_insert (GActionMuxer *muxer, g_action_muxer_insert (GActionMuxer *muxer,
const gchar *prefix, const gchar *prefix,
@ -451,7 +445,7 @@ g_action_muxer_insert (GActionMuxer *muxer,
G_CALLBACK (g_action_muxer_action_state_changed), group); G_CALLBACK (g_action_muxer_action_state_changed), group);
} }
/** /*
* g_action_muxer_remove: * g_action_muxer_remove:
* @muxer: a #GActionMuxer * @muxer: a #GActionMuxer
* @prefix: the prefix of the action group to remove * @prefix: the prefix of the action group to remove
@ -460,9 +454,7 @@ g_action_muxer_insert (GActionMuxer *muxer,
* *
* If any #GActionObservers are registered for actions in the group, * If any #GActionObservers are registered for actions in the group,
* "action_removed" notifications will be emitted, as appropriate. * "action_removed" notifications will be emitted, as appropriate.
* */
* Since: 2.32
**/
void void
g_action_muxer_remove (GActionMuxer *muxer, g_action_muxer_remove (GActionMuxer *muxer,
const gchar *prefix) const gchar *prefix)
@ -491,13 +483,11 @@ g_action_muxer_remove (GActionMuxer *muxer,
} }
} }
/** /*
* g_action_muxer_new: * g_action_muxer_new:
* *
* Creates a new #GActionMuxer. * Creates a new #GActionMuxer.
* */
* Since: 2.32
**/
GActionMuxer * GActionMuxer *
g_action_muxer_new (void) g_action_muxer_new (void)
{ {

View File

@ -25,12 +25,10 @@
G_DEFINE_INTERFACE (GActionObservable, g_action_observable, G_TYPE_OBJECT) G_DEFINE_INTERFACE (GActionObservable, g_action_observable, G_TYPE_OBJECT)
/** /*
* SECTION:gactionobserable * SECTION:gactionobserable
* @short_description: an interface implemented by objects that report * @short_description: an interface implemented by objects that report
* changes to actions * changes to actions
*
* Since: 2.32
*/ */
void void
@ -38,7 +36,7 @@ g_action_observable_default_init (GActionObservableInterface *iface)
{ {
} }
/** /*
* g_action_observable_register_observer: * g_action_observable_register_observer:
* @observable: a #GActionObservable * @observable: a #GActionObservable
* @action_name: the name of the action * @action_name: the name of the action
@ -46,9 +44,7 @@ g_action_observable_default_init (GActionObservableInterface *iface)
* *
* Registers @observer as being interested in changes to @action_name on * Registers @observer as being interested in changes to @action_name on
* @observable. * @observable.
* */
* Since: 2.32
**/
void void
g_action_observable_register_observer (GActionObservable *observable, g_action_observable_register_observer (GActionObservable *observable,
const gchar *action_name, const gchar *action_name,
@ -60,7 +56,7 @@ g_action_observable_register_observer (GActionObservable *observable,
->register_observer (observable, action_name, observer); ->register_observer (observable, action_name, observer);
} }
/** /*
* g_action_observable_unregister_observer: * g_action_observable_unregister_observer:
* @observable: a #GActionObservable * @observable: a #GActionObservable
* @action_name: the name of the action * @action_name: the name of the action
@ -71,9 +67,7 @@ g_action_observable_register_observer (GActionObservable *observable,
* *
* If the observer was registered multiple times, it must be * If the observer was registered multiple times, it must be
* unregistered an equal number of times. * unregistered an equal number of times.
* */
* Since: 2.32
**/
void void
g_action_observable_unregister_observer (GActionObservable *observable, g_action_observable_unregister_observer (GActionObservable *observable,
const gchar *action_name, const gchar *action_name,

View File

@ -49,8 +49,6 @@ G_DEFINE_INTERFACE (GActionObserver, g_action_observer, G_TYPE_OBJECT)
* - even if quarking is acceptable, #GObject signal details are * - even if quarking is acceptable, #GObject signal details are
* implemented by scanning a linked list, so there is no real * implemented by scanning a linked list, so there is no real
* decrease in complexity * decrease in complexity
*
* Since: 2.32
*/ */
void void
@ -58,7 +56,7 @@ g_action_observer_default_init (GActionObserverInterface *class)
{ {
} }
/** /*
* g_action_observer_action_added: * g_action_observer_action_added:
* @observer: a #GActionObserver * @observer: a #GActionObserver
* @observable: the source of the event * @observable: the source of the event
@ -74,9 +72,7 @@ g_action_observer_default_init (GActionObserverInterface *class)
* *
* This function should only be called by objects with which the * This function should only be called by objects with which the
* observer has explicitly registered itself to receive events. * observer has explicitly registered itself to receive events.
* */
* Since: 2.32
**/
void void
g_action_observer_action_added (GActionObserver *observer, g_action_observer_action_added (GActionObserver *observer,
GActionObservable *observable, GActionObservable *observable,
@ -91,7 +87,7 @@ g_action_observer_action_added (GActionObserver *observer,
->action_added (observer, observable, action_name, parameter_type, enabled, state); ->action_added (observer, observable, action_name, parameter_type, enabled, state);
} }
/** /*
* g_action_observer_action_enabled_changed: * g_action_observer_action_enabled_changed:
* @observer: a #GActionObserver * @observer: a #GActionObserver
* @observable: the source of the event * @observable: the source of the event
@ -103,9 +99,7 @@ g_action_observer_action_added (GActionObserver *observer,
* *
* This function should only be called by objects with which the * This function should only be called by objects with which the
* observer has explicitly registered itself to receive events. * observer has explicitly registered itself to receive events.
* */
* Since: 2.32
**/
void void
g_action_observer_action_enabled_changed (GActionObserver *observer, g_action_observer_action_enabled_changed (GActionObserver *observer,
GActionObservable *observable, GActionObservable *observable,
@ -118,7 +112,7 @@ g_action_observer_action_enabled_changed (GActionObserver *observer,
->action_enabled_changed (observer, observable, action_name, enabled); ->action_enabled_changed (observer, observable, action_name, enabled);
} }
/** /*
* g_action_observer_action_state_changed: * g_action_observer_action_state_changed:
* @observer: a #GActionObserver * @observer: a #GActionObserver
* @observable: the source of the event * @observable: the source of the event
@ -130,9 +124,7 @@ g_action_observer_action_enabled_changed (GActionObserver *observer,
* *
* This function should only be called by objects with which the * This function should only be called by objects with which the
* observer has explicitly registered itself to receive events. * observer has explicitly registered itself to receive events.
* */
* Since: 2.32
**/
void void
g_action_observer_action_state_changed (GActionObserver *observer, g_action_observer_action_state_changed (GActionObserver *observer,
GActionObservable *observable, GActionObservable *observable,
@ -145,7 +137,7 @@ g_action_observer_action_state_changed (GActionObserver *observer,
->action_state_changed (observer, observable, action_name, state); ->action_state_changed (observer, observable, action_name, state);
} }
/** /*
* g_action_observer_action_removed: * g_action_observer_action_removed:
* @observer: a #GActionObserver * @observer: a #GActionObserver
* @observable: the source of the event * @observable: the source of the event
@ -156,9 +148,7 @@ g_action_observer_action_state_changed (GActionObserver *observer,
* *
* This function should only be called by objects with which the * This function should only be called by objects with which the
* observer has explicitly registered itself to receive events. * observer has explicitly registered itself to receive events.
* */
* Since: 2.32
**/
void void
g_action_observer_action_removed (GActionObserver *observer, g_action_observer_action_removed (GActionObserver *observer,
GActionObservable *observable, GActionObservable *observable,