From ad0c36e1a1a0df5c0ff1f4449c54918e775e965d Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Tue, 17 Aug 2010 14:54:20 +0100 Subject: [PATCH] docs: Fixes to avoid gtk-doc warnings --- clutter/clutter-actor.c | 57 ++++++++++-------------------- clutter/clutter-actor.h | 4 +-- clutter/clutter-behaviour-path.c | 6 ++-- clutter/clutter-colorize-effect.c | 2 +- clutter/clutter-drag-action.c | 2 +- clutter/clutter-script.c | 2 +- doc/reference/clutter/clutter-docs.xml.in | 7 +++- doc/reference/clutter/clutter-overview.xml | 23 ++++++++---- 8 files changed, 48 insertions(+), 55 deletions(-) diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c index 7443160..4d0bce8 100644 --- a/clutter/clutter-actor.c +++ b/clutter/clutter-actor.c @@ -1034,10 +1034,10 @@ clutter_actor_real_map (ClutterActor *self) * actor is not visible. * * Calling this is allowed in only one case: you are implementing the - * #ClutterActor::map virtual function in an actor and you need to map - * the children of that actor. It is not necessary to call this - * if you implement #ClutterContainer because the default implementation - * will automatically map children of containers. + * #ClutterActor map() virtual function in an actor + * and you need to map the children of that actor. It is not necessary + * to call this if you implement #ClutterContainer because the default + * implementation will automatically map children of containers. * * When overriding map, it is mandatory to chain up to the parent * implementation. @@ -1098,10 +1098,10 @@ clutter_actor_real_unmap (ClutterActor *self) * unmaps its children if they were mapped. * * Calling this is allowed in only one case: you are implementing the - * #ClutterActor::unmap virtual function in an actor and you need to - * unmap the children of that actor. It is not necessary to call this - * if you implement #ClutterContainer because the default implementation - * will automatically unmap children of containers. + * #ClutterActor unmap() virtual function in an actor + * and you need to unmap the children of that actor. It is not necessary + * to call this if you implement #ClutterContainer because the default + * implementation will automatically unmap children of containers. * * When overriding unmap, it is mandatory to chain up to the parent * implementation. @@ -1412,7 +1412,15 @@ clutter_actor_real_unrealize (ClutterActor *self) * sure it isn't mapped, an application-visible side effect that you * may not be expecting. * - * This function should not really be in the public API, because + * This function should not be called by application code. + */ +void +clutter_actor_unrealize (ClutterActor *self) +{ + g_return_if_fail (CLUTTER_IS_ACTOR (self)); + g_return_if_fail (!CLUTTER_ACTOR_IS_MAPPED (self)); + +/* This function should not really be in the public API, because * there isn't a good reason to call it. ClutterActor will already * unrealize things for you when it's important to do so. * @@ -1429,11 +1437,6 @@ clutter_actor_real_unrealize (ClutterActor *self) * _clutter_actor_rerealize() (inside Clutter) or just call your * code that recreates your resources directly (outside Clutter). */ -void -clutter_actor_unrealize (ClutterActor *self) -{ - g_return_if_fail (CLUTTER_IS_ACTOR (self)); - g_return_if_fail (!CLUTTER_ACTOR_IS_MAPPED (self)); #ifdef CLUTTER_ENABLE_DEBUG clutter_actor_verify_map_state (self); @@ -4642,7 +4645,7 @@ clutter_actor_class_init (ClutterActorClass *klass) * ClutterActor::key-focus-in: * @actor: the actor which now has key focus * - * The ::focus-in signal is emitted when @actor recieves key focus. + * The ::key-focus-in signal is emitted when @actor receives key focus. * * Since: 0.6 */ @@ -4802,30 +4805,6 @@ clutter_actor_class_init (ClutterActorClass *klass) G_TYPE_NONE, 0); /** - * ClutterActor::map: - * @actor: the #ClutterActor to map - * - * The ::map virtual functon must be overridden in order to call - * clutter_actor_map() on any child actors if the actor is not a - * #ClutterContainer. When overriding, it is mandatory to chain up - * to the parent implementation. - * - * Since: 1.0 - */ - - /** - * ClutterActor::unmap: - * @actor: the #ClutterActor to unmap - * - * The ::unmap virtual functon must be overridden in order to call - * clutter_actor_unmap() on any child actors if the actor is not a - * #ClutterContainer. When overriding, it is mandatory to chain up - * to the parent implementation. - * - * Since: 1.0 - */ - - /** * ClutterActor::pick: * @actor: the #ClutterActor that received the signal * @color: the #ClutterColor to be used when picking diff --git a/clutter/clutter-actor.h b/clutter/clutter-actor.h index c4ede38..830c982 100644 --- a/clutter/clutter-actor.h +++ b/clutter/clutter-actor.h @@ -229,8 +229,8 @@ struct _ClutterActor * @enter_event: signal class closure for #ClutterActor::enter-event * @leave_event: signal class closure for #ClutterActor::leave-event * @captured_event: signal class closure for #ClutterActor::captured-event - * @key_focus_in: signal class closure for #ClutterActor::focus-in - * @key_focus_out: signal class closure for #ClutterActor::focus-out + * @key_focus_in: signal class closure for #ClutterActor::key-focus-in + * @key_focus_out: signal class closure for #ClutterActor::key-focus-out * @queue_relayout: class handler for #ClutterActor::queue-relayout * * Base class for actors. diff --git a/clutter/clutter-behaviour-path.c b/clutter/clutter-behaviour-path.c index c0238fa..d836fa9 100644 --- a/clutter/clutter-behaviour-path.c +++ b/clutter/clutter-behaviour-path.c @@ -51,8 +51,8 @@ * ]| * * If the alpha function is a periodic function, i.e. it returns to - * 0 after reaching %CLUTTER_ALPHA_MAX_ALPHA, then the actors will walk - * the path back to the starting #ClutterKnot. + * 0.0 after reaching 1.0, then the actors will walk the path back to the + * starting #ClutterKnot. * * #ClutterBehaviourPath is available since Clutter 0.2 */ @@ -225,7 +225,7 @@ clutter_behaviour_path_class_init (ClutterBehaviourPathClass *klass) /** * ClutterBehaviourPath::knot-reached: * @pathb: the object which received the signal - * @knot_num: the index of the #ClutterPathKnot reached + * @knot_num: the index of the #ClutterKnot reached * * This signal is emitted each time a node defined inside the path * is reached. diff --git a/clutter/clutter-colorize-effect.c b/clutter/clutter-colorize-effect.c index bf04941..b060585 100644 --- a/clutter/clutter-colorize-effect.c +++ b/clutter/clutter-colorize-effect.c @@ -325,7 +325,7 @@ clutter_colorize_effect_init (ClutterColorizeEffect *self) * @tint: the color to be used * * Creates a new #ClutterColorizeEffect to be used with - * clutter_actor_set_effect() + * clutter_actor_add_effect() * * Return value: the newly created #ClutterColorizeEffect or %NULL * diff --git a/clutter/clutter-drag-action.c b/clutter/clutter-drag-action.c index 0012b05..0ca4dc2 100644 --- a/clutter/clutter-drag-action.c +++ b/clutter/clutter-drag-action.c @@ -490,7 +490,7 @@ clutter_drag_action_class_init (ClutterDragActionClass *klass) * * The #ClutterActor that is effectively being dragged * - * A #ClutterDragActor will, be default, use the #ClutterActor that + * A #ClutterDragAction will, be default, use the #ClutterActor that * has been attached to the action; it is possible to create a * separate #ClutterActor and use it instead. * diff --git a/clutter/clutter-script.c b/clutter/clutter-script.c index 65ca072..b5be526 100644 --- a/clutter/clutter-script.c +++ b/clutter/clutter-script.c @@ -474,7 +474,7 @@ clutter_script_new (void) * * Return value: on error, zero is returned and @error is set * accordingly. On success, the merge id for the UI definitions is - * returned. You can use the merge id with clutter_script_unmerge(). + * returned. You can use the merge id with clutter_script_unmerge_objects(). * * Since: 0.6 */ diff --git a/doc/reference/clutter/clutter-docs.xml.in b/doc/reference/clutter/clutter-docs.xml.in index fd6ea0c..87ba7ae 100644 --- a/doc/reference/clutter/clutter-docs.xml.in +++ b/doc/reference/clutter/clutter-docs.xml.in @@ -204,7 +204,12 @@ - + + + + + + diff --git a/doc/reference/clutter/clutter-overview.xml b/doc/reference/clutter/clutter-overview.xml index a015fd2..5a2fc9c 100644 --- a/doc/reference/clutter/clutter-overview.xml +++ b/doc/reference/clutter/clutter-overview.xml @@ -28,8 +28,8 @@ Actors are also able to receive events. Subclasses of #ClutterActor include #ClutterStage, #ClutterTexture, - #ClutterLabel, #ClutterRectangle, #ClutterEntry and - #ClutterGroup. #ClutterActors are added to a parent, transformed + #ClutterText, #ClutterRectangle, #ClutterCairoTexture, #ClutterGroup and + #ClutterBox. #ClutterActors are added to a parent, transformed and then made visible. #ClutterStage is the top level #ClutterActor - it's the @@ -37,16 +37,25 @@ when Clutter is initialised. #ClutterStage is a #ClutterGroup, a class implementing the #ClutterCointainer interface. + Clutter allows explicit positioning and sizing through the + #ClutterFixedLayout layout manager; and implicit positioning and sizing + through fluid layout managers like #ClutterBoxLayout, #ClutterFlowLayout + and #ClutterTableLayout. Actors inside fixed layout managers like + #ClutterGroup and #ClutterStage can also be positioned and sized implicitly + using the #ClutterConstraint sub-classes. + #ClutterTimelines provide the basis for Clutter's animation - utilities. Multiple timelines can be synchronised using #ClutterScore, - and #ClutterBehaviour and #ClutterEffect allow for the creation of - animation effects such as transitions. + utilities. #ClutterActors can be animated using explicit animations + through the various #ClutterBehaviour implementations, or implicit + animations, through the clutter_actor_animate() function. Animations can + also be defined as named states through the #ClutterState class. Clutter further contains a number of utilities, including; #ClutterScript - for loading 'UI definition' files formatted in - JSON, #ClutterShader - a + JSON; #ClutterShader - a class for applying GPU shaders to actors, #ClutterModel - a utility class - for MVC list type implementations, and fixed point math utilities. + for MVC list type implementations; #ClutterActions, + #ClutterConstraints and #ClutterEffects. -- 2.7.4