summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDieter Verfaillie <dieterv@optionexplicit.be>2012-04-03 20:17:00 +0200
committerJohan Dahlin <jdahlin@litl.com>2012-04-05 10:23:42 -0300
commit0183c1f8a158834e5bfb601d4a207a8cff0b2b62 (patch)
tree158150f6c006600efd68e0ab28e554427a9f32ee
parentfefe5d9a20756d58f4207ae26553d65d54037b20 (diff)
downloadglib-0183c1f8a158834e5bfb601d4a207a8cff0b2b62.tar.gz
Fix malformed GTK-Doc comment blocks: invalid parameters and tags.
Found these thanks to the improved gobject-introspection GTK-Doc comment block/annotation parser. See https://bugzilla.gnome.org/show_bug.cgi?id=672254 https://bugzilla.gnome.org/show_bug.cgi?id=673385
-rw-r--r--gio/gremoteactiongroup.c2
-rw-r--r--glib/gasyncqueue.c4
-rw-r--r--glib/gmem.c1
-rw-r--r--gobject/gtype.c2
4 files changed, 4 insertions, 5 deletions
diff --git a/gio/gremoteactiongroup.c b/gio/gremoteactiongroup.c
index 9f1ee9a9b..1b6f34217 100644
--- a/gio/gremoteactiongroup.c
+++ b/gio/gremoteactiongroup.c
@@ -81,7 +81,7 @@ g_remote_action_group_default_init (GRemoteActionGroupInterface *iface)
* g_remote_action_group_activate_action_full:
* @remote: a #GDBusActionGroup
* @action_name: the name of the action to activate
- * @parameter: (allow none): the optional parameter to the activation
+ * @parameter: (allow-none): the optional parameter to the activation
* @platform_data: the platform data to send
*
* Activates the remote action.
diff --git a/glib/gasyncqueue.c b/glib/gasyncqueue.c
index 31976bcea..075266f5f 100644
--- a/glib/gasyncqueue.c
+++ b/glib/gasyncqueue.c
@@ -176,7 +176,7 @@ g_async_queue_ref (GAsyncQueue *queue)
*
* Increases the reference count of the asynchronous @queue by 1.
*
- * @Deprecated: Since 2.8, reference counting is done atomically
+ * Deprecated: 2.8: Reference counting is done atomically.
* so g_async_queue_ref() can be used regardless of the @queue's
* lock.
*/
@@ -197,7 +197,7 @@ g_async_queue_ref_unlocked (GAsyncQueue *queue)
* the @queue's lock. If the reference count went to 0, the @queue
* will be destroyed and the memory allocated will be freed.
*
- * @Deprecated: Since 2.8, reference counting is done atomically
+ * Deprecated: 2.8: Reference counting is done atomically.
* so g_async_queue_unref() can be used regardless of the @queue's
* lock.
*/
diff --git a/glib/gmem.c b/glib/gmem.c
index afb94c191..1f01cd1e3 100644
--- a/glib/gmem.c
+++ b/glib/gmem.c
@@ -659,7 +659,6 @@ profile_print_locked (guint *local_data,
/**
* g_mem_profile:
- * @void:
*
* Outputs a summary of memory usage.
*
diff --git a/gobject/gtype.c b/gobject/gtype.c
index d78a8970b..43fdbc684 100644
--- a/gobject/gtype.c
+++ b/gobject/gtype.c
@@ -4058,7 +4058,7 @@ g_type_check_class_cast (GTypeClass *type_class,
* Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE()
* macro.
*
- * @Returns: #TRUE if @instance is valid, #FALSE otherwise.
+ * Returns: %TRUE if @instance is valid, %FALSE otherwise.
*/
gboolean
g_type_check_instance (GTypeInstance *type_instance)