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>
/**
/*
* SECTION:gactionmuxer
* @short_description: Aggregate and monitor several action groups
*
@ -54,9 +54,7 @@
* This class is typically only used at the site of "consumption" of
* actions (eg: when displaying a menu that contains many actions on
* different objects).
*
* Since: 2.32
**/
*/
static void g_action_muxer_group_iface_init (GActionGroupInterface *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;
GSList *node;
g_print ("feeling changes\n");
action = g_action_muxer_lookup_action (group->muxer, group->prefix, action_name, &fullname);
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);
@ -395,7 +391,7 @@ g_action_muxer_class_init (GObjectClass *class)
class->finalize = g_action_muxer_finalize;
}
/**
/*
* g_action_muxer_insert:
* @muxer: a #GActionMuxer
* @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.
*
* @prefix must not contain a dot ('.').
*
* Since: 2.32
**/
*/
void
g_action_muxer_insert (GActionMuxer *muxer,
const gchar *prefix,
@ -451,7 +445,7 @@ g_action_muxer_insert (GActionMuxer *muxer,
G_CALLBACK (g_action_muxer_action_state_changed), group);
}
/**
/*
* g_action_muxer_remove:
* @muxer: a #GActionMuxer
* @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,
* "action_removed" notifications will be emitted, as appropriate.
*
* Since: 2.32
**/
*/
void
g_action_muxer_remove (GActionMuxer *muxer,
const gchar *prefix)
@ -491,13 +483,11 @@ g_action_muxer_remove (GActionMuxer *muxer,
}
}
/**
/*
* g_action_muxer_new:
*
* Creates a new #GActionMuxer.
*
* Since: 2.32
**/
*/
GActionMuxer *
g_action_muxer_new (void)
{

View File

@ -25,12 +25,10 @@
G_DEFINE_INTERFACE (GActionObservable, g_action_observable, G_TYPE_OBJECT)
/**
/*
* SECTION:gactionobserable
* @short_description: an interface implemented by objects that report
* changes to actions
*
* Since: 2.32
*/
void
@ -38,7 +36,7 @@ g_action_observable_default_init (GActionObservableInterface *iface)
{
}
/**
/*
* g_action_observable_register_observer:
* @observable: a #GActionObservable
* @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
* @observable.
*
* Since: 2.32
**/
*/
void
g_action_observable_register_observer (GActionObservable *observable,
const gchar *action_name,
@ -60,7 +56,7 @@ g_action_observable_register_observer (GActionObservable *observable,
->register_observer (observable, action_name, observer);
}
/**
/*
* g_action_observable_unregister_observer:
* @observable: a #GActionObservable
* @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
* unregistered an equal number of times.
*
* Since: 2.32
**/
*/
void
g_action_observable_unregister_observer (GActionObservable *observable,
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
* implemented by scanning a linked list, so there is no real
* decrease in complexity
*
* Since: 2.32
*/
void
@ -58,7 +56,7 @@ g_action_observer_default_init (GActionObserverInterface *class)
{
}
/**
/*
* g_action_observer_action_added:
* @observer: a #GActionObserver
* @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
* observer has explicitly registered itself to receive events.
*
* Since: 2.32
**/
*/
void
g_action_observer_action_added (GActionObserver *observer,
GActionObservable *observable,
@ -91,7 +87,7 @@ g_action_observer_action_added (GActionObserver *observer,
->action_added (observer, observable, action_name, parameter_type, enabled, state);
}
/**
/*
* g_action_observer_action_enabled_changed:
* @observer: a #GActionObserver
* @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
* observer has explicitly registered itself to receive events.
*
* Since: 2.32
**/
*/
void
g_action_observer_action_enabled_changed (GActionObserver *observer,
GActionObservable *observable,
@ -118,7 +112,7 @@ g_action_observer_action_enabled_changed (GActionObserver *observer,
->action_enabled_changed (observer, observable, action_name, enabled);
}
/**
/*
* g_action_observer_action_state_changed:
* @observer: a #GActionObserver
* @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
* observer has explicitly registered itself to receive events.
*
* Since: 2.32
**/
*/
void
g_action_observer_action_state_changed (GActionObserver *observer,
GActionObservable *observable,
@ -145,7 +137,7 @@ g_action_observer_action_state_changed (GActionObserver *observer,
->action_state_changed (observer, observable, action_name, state);
}
/**
/*
* g_action_observer_action_removed:
* @observer: a #GActionObserver
* @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
* observer has explicitly registered itself to receive events.
*
* Since: 2.32
**/
*/
void
g_action_observer_action_removed (GActionObserver *observer,
GActionObservable *observable,