# HG changeset patch
# User Daniel Atallah <daniel.atallah@gmail.com>
# Date 1266512322 0
# Node ID 36da826c60022ab8d2d5300f0d160ba0bfe1679a
# Parent  ae1c7756f1bd97d69c26e8196bf6fe5b844b2d06
Update pidgin_blist_get_emblem() docs to be accurate.

diff -r ae1c7756f1bd -r 36da826c6002 pidgin/gtkblist.h
--- a/pidgin/gtkblist.h	Thu Feb 18 16:43:29 2010 +0000
+++ b/pidgin/gtkblist.h	Thu Feb 18 16:58:42 2010 +0000
@@ -196,11 +196,14 @@
 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);