Update pidgin_blist_get_emblem() docs to be accurate.

1 files changed, 5 insertions, 2 deletions

diff --git a/pidgin/gtkblist.h b/pidgin/gtkblist.h
index c221f8fcc6..2f0a128823 100644
--- a/pidgin/gtkblist.h
+++ b/pidgin/gtkblist.h
@@ -196,11 +196,14 @@ void pidgin_blist_update_columns(void);
 void pidgin_blist_update_refresh_timeout(void);
 
 /**
- * Returns the blist emblem
+ * Returns the blist emblem.
+ *
+ * This may be an existing pixbuf that has been given an additional ref,
+ * so it shouldn't be modified.
  *
  * @param node   The node to return an emblem for
  *
- * @return  A newly created GdkPixbuf, or NULL
+ * @return  A GdkPixbuf for the emblem to show, or NULL
  */
 GdkPixbuf *
 pidgin_blist_get_emblem(PurpleBlistNode *node);