From b6954536f32352c0c29fe5a9a73de1018559a9c5 Mon Sep 17 00:00:00 2001 From: Dieter Verfaillie Date: Thu, 25 Jul 2013 17:49:11 +0200 Subject: 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 --- tests/scanner/annotation.c | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) (limited to 'tests/scanner/annotation.c') diff --git a/tests/scanner/annotation.c b/tests/scanner/annotation.c index 32187d38..30dc72ef 100644 --- a/tests/scanner/annotation.c +++ b/tests/scanner/annotation.c @@ -163,9 +163,7 @@ regress_annotation_object_class_init (RegressAnnotationObjectClass *klass) NULL, G_PARAM_READWRITE | G_PARAM_CONSTRUCT)); /** - * RegressAnnotationObject:function-property: - * - * Type: RegressAnnotationCallback + * RegressAnnotationObject:function-property: (type RegressAnnotationCallback) */ g_object_class_install_property (gobject_class, PROP_FUNCTION_PROPERTY, @@ -616,15 +614,13 @@ regress_annotation_object_watch (RegressAnnotationObject *object, } /** - * regress_annotation_object_watch_full: + * regress_annotation_object_watch_full: (rename-to regress_annotation_object_watch) * @object: A #RegressAnnotationObject * @func: The callback * @user_data: The callback data * @destroy: Destroy notification * * Test overriding via the "Rename To" annotation. - * - * Rename to: regress_annotation_object_watch */ void regress_annotation_object_watch_full (RegressAnnotationObject *object, -- cgit v1.2.1