diff options
author | Dieter Verfaillie <dieterv@optionexplicit.be> | 2013-07-25 17:49:11 +0200 |
---|---|---|
committer | Dieter Verfaillie <dieterv@optionexplicit.be> | 2013-10-08 20:55:50 +0200 |
commit | b6954536f32352c0c29fe5a9a73de1018559a9c5 (patch) | |
tree | f0e50185f5c8f0fbe7b0f425fa66a214e926d3e9 /gir/gobject-2.0.c | |
parent | a2b22ce75937d2d996ef90e0ab683d36031365d0 (diff) | |
download | gobject-introspection-b6954536f32352c0c29fe5a9a73de1018559a9c5.tar.gz |
giscanner: deprecate GObject-Introspection GTK-Doc tags
After discussing a different issue with the GTK-Doc maintainers,
we learned that our g-i specific top level tags should never have
existed in the first place. The prefered notation for annotations
that apply to the identifier should be written on the identifier
line, for example like what we already do with (skip).
As a result, this patch deprecates g-i specific top level tags and
implements them as annotations on the identifier instead but still
keeps support for malformed comment blocks using g-i specific top
level tags.
This means that all annotated code "out there" will continue to work
just fine with this version of g-i, but when a developer decides to
fix deprecation warnings in his/her comment blocks, the dependency
on g-i needs to be raised to a version that contains at least this
patch. #676133
https://bugzilla.gnome.org/show_bug.cgi?id=676133
Diffstat (limited to 'gir/gobject-2.0.c')
-rw-r--r-- | gir/gobject-2.0.c | 9 |
1 files changed, 3 insertions, 6 deletions
diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c index cb50341a..98879df0 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -1770,7 +1770,7 @@ /** - * g_object_bind_property_with_closures: + * g_object_bind_property_with_closures: (rename-to g_object_bind_property_full) * @source: (type GObject.Object): the source #GObject * @source_property: the property on @source to bind * @target: (type GObject.Object): the target #GObject @@ -1787,7 +1787,6 @@ * g_object_bind_property_full(), using #GClosure<!-- -->s instead of * function pointers. * - * Rename to: g_object_bind_property_full * Returns: (transfer none): the #GBinding instance representing the binding between the two #GObject instances. The binding is released whenever the #GBinding reference count reaches zero. * Since: 2.26 */ @@ -2300,7 +2299,7 @@ /** - * g_object_newv: + * g_object_newv: (rename-to g_object_new) * @object_type: the type id of the #GObject subtype to instantiate * @n_parameters: the length of the @parameters array * @parameters: (array length=n_parameters): an array of #GParameter @@ -2310,7 +2309,6 @@ * Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) * which are not explicitly specified are set to their default values. * - * Rename to: g_object_new * Returns: (type GObject.Object) (transfer full): a new instance of @object_type */ @@ -5218,7 +5216,7 @@ /** - * g_value_array_sort_with_data: + * g_value_array_sort_with_data: (rename-to g_value_array_sort) * @value_array: #GValueArray to sort * @compare_func: (scope call): function to compare elements * @user_data: (closure): extra data argument provided for @compare_func @@ -5229,7 +5227,6 @@ * The current implementation uses the same sorting algorithm as standard * C qsort() function. * - * Rename to: g_value_array_sort * Returns: (transfer none): the #GValueArray passed in as @value_array * Deprecated: 2.32: Use #GArray and g_array_sort_with_data(). */ |