From 56beb181035248b4aff6927b3397708755ce6588 Mon Sep 17 00:00:00 2001 From: Jonny Lamb Date: Thu, 23 Apr 2009 10:03:06 +0100 Subject: Misc. gtk-doc updates, including being more explicit about refs. Signed-off-by: Jonny Lamb --- libempathy-gtk/empathy-account-chooser.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'libempathy-gtk/empathy-account-chooser.c') diff --git a/libempathy-gtk/empathy-account-chooser.c b/libempathy-gtk/empathy-account-chooser.c index aa6cf29e0..5d11e8e1e 100644 --- a/libempathy-gtk/empathy-account-chooser.c +++ b/libempathy-gtk/empathy-account-chooser.c @@ -254,7 +254,7 @@ empathy_account_chooser_new (void) * * Returns the account which is currently selected in the chooser or %NULL * if there is no account selected. The #McAccount returned should be - * unrefed when finished with. + * unrefed with g_object_unref() when finished with. * * Return value: a new ref to the #McAccount currently selected, or %NULL. */ @@ -284,9 +284,12 @@ empathy_account_chooser_dup_account (EmpathyAccountChooser *chooser) * empathy_account_chooser_get_connection: * @chooser: an #EmpathyAccountChooser * - * Returns the #TpConnection associated with the account currently selected. + * Returns a borrowed reference to the #TpConnection associated with the + * account currently selected. The caller must reference the returned object with + * g_object_ref() if it will be kept * - * Return value: the #TpConnection associated with the account curently selected. + * Return value: a borrowed reference to the #TpConnection associated with the + * account curently selected. */ TpConnection * empathy_account_chooser_get_connection (EmpathyAccountChooser *chooser) -- cgit v1.2.3