[girepository] Update gtk-doc syntax

Update the gtk-doc syntax to remove a couple of warnings
This commit is contained in:
Johan Dahlin 2010-05-18 13:37:51 -03:00
parent c9213eaea3
commit 9f4cadec60
3 changed files with 10 additions and 8 deletions

14
ginfo.c
View File

@ -30,7 +30,7 @@
typedef struct _GIRealInfo GIRealInfo; typedef struct _GIRealInfo GIRealInfo;
/** /*
* We just use one structure for all of the info object * We just use one structure for all of the info object
* types; in general, we should be reading data directly * types; in general, we should be reading data directly
* from the typelib, and not having computed data in * from the typelib, and not having computed data in
@ -437,7 +437,7 @@ find_first_attribute (GIRealInfo *rinfo)
/** /**
* g_base_info_iterate_attributes: * g_base_info_iterate_attributes:
* @info: A #GIBaseInfo * @info: A #GIBaseInfo
* @iter: A #GIAttributeIter structure, must be initialized; see below * @iterator: A #GIAttributeIter structure, must be initialized; see below
* @name: (out) (transfer none): Returned name, must not be freed * @name: (out) (transfer none): Returned name, must not be freed
* @value: (out) (transfer none): Returned name, must not be freed * @value: (out) (transfer none): Returned name, must not be freed
* *
@ -469,7 +469,7 @@ find_first_attribute (GIRealInfo *rinfo)
*/ */
gboolean gboolean
g_base_info_iterate_attributes (GIBaseInfo *info, g_base_info_iterate_attributes (GIBaseInfo *info,
GIAttributeIter *iter, GIAttributeIter *iterator,
gchar **name, gchar **name,
gchar **value) gchar **value)
{ {
@ -480,8 +480,8 @@ g_base_info_iterate_attributes (GIBaseInfo *info,
after = (AttributeBlob *) &rinfo->typelib->data[header->attributes + after = (AttributeBlob *) &rinfo->typelib->data[header->attributes +
header->n_attributes * header->attribute_blob_size]; header->n_attributes * header->attribute_blob_size];
if (iter->data != NULL) if (iterator->data != NULL)
next = (AttributeBlob *) iter->data; next = (AttributeBlob *) iterator->data;
else else
next = find_first_attribute (rinfo); next = find_first_attribute (rinfo);
@ -490,7 +490,7 @@ g_base_info_iterate_attributes (GIBaseInfo *info,
*name = (gchar*) g_typelib_get_string (rinfo->typelib, next->name); *name = (gchar*) g_typelib_get_string (rinfo->typelib, next->name);
*value = (gchar*) g_typelib_get_string (rinfo->typelib, next->value); *value = (gchar*) g_typelib_get_string (rinfo->typelib, next->value);
iter->data = next + 1; iterator->data = next + 1;
return TRUE; return TRUE;
} }
@ -994,6 +994,8 @@ g_type_info_get_param_type (GITypeInfo *info,
* this function returns full information about the referenced type. You can then * this function returns full information about the referenced type. You can then
* inspect the type of the returned #GIBaseInfo to further query whether it is * inspect the type of the returned #GIBaseInfo to further query whether it is
* a concrete GObject, a GInterface, a structure, etc. using g_base_info_get_type(). * a concrete GObject, a GInterface, a structure, etc. using g_base_info_get_type().
*
* Returns: a struct representing the interface or %NULL
*/ */
GIBaseInfo * GIBaseInfo *
g_type_info_get_interface (GITypeInfo *info) g_type_info_get_interface (GITypeInfo *info)

View File

@ -856,7 +856,7 @@ g_irepository_get_shared_library (GIRepository *repository,
/** /**
* g_irepository_get_c_prefix * g_irepository_get_c_prefix
* @repository: A #GIRepository, may be %NULL for the default * @repository: A #GIRepository, may be %NULL for the default
* @namespace: Namespace to inspect * @namespace_: Namespace to inspect
* *
* This function returns the "C prefix", or the C level namespace * This function returns the "C prefix", or the C level namespace
* associated with the given introspection namespace. Each C symbol * associated with the given introspection namespace. Each C symbol

View File

@ -717,7 +717,7 @@ typedef struct {
} StructBlob; } StructBlob;
/** /**
* UnionBlob; * UnionBlob:
* @unregistered: If this is set, the type is not registered with GType. * @unregistered: If this is set, the type is not registered with GType.
* @discriminated: Is set if the union is discriminated * @discriminated: Is set if the union is discriminated
* @alignment: The byte boundary that the union is aligned to in memory * @alignment: The byte boundary that the union is aligned to in memory