# HG changeset patch
# User Daniel Atallah <datallah@pidgin.im>
# Date 1266512322 0
# Node ID 62c59080a6bfb446bfbab3d8d1d37c9084e13b26
# Parent  5359b79e2b47a39006fe70add6ec6b5da256d0b2
Update pidgin_blist_get_emblem() docs to be accurate.

diff -r 5359b79e2b47 -r 62c59080a6bf 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);