diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2011-03-29 16:34:38 +0100 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2011-09-27 15:29:44 +0100 |
commit | 53ac9ee390e173f8e63f276d8c7e211e4fadca4b (patch) | |
tree | beecd49a4c25e8a1649010690de37edad748e827 /dbus/dbus-glib.c | |
parent | be937e037a6c076cf650bb79aba9c1138da39511 (diff) |
Clean up docs for DBusGConnection
* introductory doc-comment for the (pseudo-)class
* attach the doc-comment for the GType to the macro, not the internal
function
* rename function parameters to match what the header file says
Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
Reviewed-by: Cosimo Alfarano <cosimo.alfarano@collabora.co.uk>
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=37793
Bug-NB: related to NB#218973
Diffstat (limited to 'dbus/dbus-glib.c')
-rw-r--r-- | dbus/dbus-glib.c | 26 |
1 files changed, 17 insertions, 9 deletions
diff --git a/dbus/dbus-glib.c b/dbus/dbus-glib.c index 3de6273..51f5141 100644 --- a/dbus/dbus-glib.c +++ b/dbus/dbus-glib.c @@ -39,6 +39,13 @@ */ /** + * DBusGConnection: + * + * A #DBusGConnection is a boxed type abstracting a DBusConnection from + * libdbus. + */ + +/** * dbus_g_connection_flush: * @connection: the #DBusGConnection to flush * @@ -52,35 +59,35 @@ dbus_g_connection_flush (DBusGConnection *connection) /** * dbus_g_connection_ref: - * @gconnection the #DBusGConnection to ref + * @connection: the #DBusGConnection to ref * * Increment refcount on a #DBusGConnection * * Returns: the connection that was ref'd */ DBusGConnection* -dbus_g_connection_ref (DBusGConnection *gconnection) +dbus_g_connection_ref (DBusGConnection *connection) { DBusConnection *c; - c = DBUS_CONNECTION_FROM_G_CONNECTION (gconnection); + c = DBUS_CONNECTION_FROM_G_CONNECTION (connection); dbus_connection_ref (c); - return gconnection; + return connection; } /** * dbus_g_connection_unref: - * @gconnection: the connection to unref + * @connection: the connection to unref * * Decrement refcount on a #DBusGConnection */ void -dbus_g_connection_unref (DBusGConnection *gconnection) +dbus_g_connection_unref (DBusGConnection *connection) { DBusConnection *c; - c = DBUS_CONNECTION_FROM_G_CONNECTION (gconnection); + c = DBUS_CONNECTION_FROM_G_CONNECTION (connection); dbus_connection_unref (c); } @@ -243,8 +250,9 @@ dbus_message_get_g_type (void) } /** - * dbus_g_connection_get_g_type: - * Get the GLib type ID for a DBusGConnection boxed type. + * DBUS_TYPE_G_CONNECTION: + * + * Expands to a function call returning the boxed #GType of a #DBusGConnection. * * Returns: the GLib type */ |