docs: Avoid warnings from the g-ir-scanner

The scanner has some issues when parsing valid gtk-doc annotations; we
should make its (and, in return, ours) life easier.

We still get warnings for code declared in <programlisting> sections,
unfortunately.
This commit is contained in:
Emmanuele Bassi
2010-06-30 14:58:47 +01:00
parent e32c6c1235
commit 7ca340fade
4 changed files with 13 additions and 14 deletions

View File

@ -230,10 +230,10 @@ clutter_align_constraint_class_init (ClutterAlignConstraintClass *klass)
*
* The alignment factor, as a normalized value between 0.0 and 1.0
*
* The #ClutterAlignConstraint:factor depends on the
* #ClutterAlignConstraint:align-axis value: with %CLUTTER_ALIGN_X_AXIS,
* 0.0 means left and 1.0 means right; with %CLUTTER_ALIGN_Y_AXIS, 0.0
* means top and 1.0 means bottom
* The factor depends on the #ClutterAlignConstraint:align-axis property:
* with an align-axis value of %CLUTTER_ALIGN_X_AXIS, 0.0 means left and
* 1.0 means right; with a value of %CLUTTER_ALIGN_Y_AXIS, 0.0 means top
* and 1.0 means bottom.
*
* Since: 1.4
*/
@ -263,8 +263,8 @@ clutter_align_constraint_init (ClutterAlignConstraint *self)
* @factor: the alignment factor, between 0.0 and 1.0
*
* Creates a new constraint, aligning a #ClutterActor's position with
* regards of the size of the actor to @source, with the given alignment
* @factor
* regards of the size of the actor to @source, with the given
* alignment @factor
*
* Return value: the newly created #ClutterAlignConstraint
*