# HG changeset patch
# User Sadrul Habib Chowdhury <imadil@gmail.com>
# Date 1194443388 0
# Node ID 45e550db32ab0c6bc726184e65d54a55781bd69f
# Parent  bddf964880cf5bfd5b6d2ca1040518703892d953# Parent  7c80ba584fb0bb07ae383df9f88d255048e63fb1
merge of '656ddea68cc0419829183e2676970ed21efb838f'
     and '9825a5529451f2000418ac3fb9c586502380a2c6'

diff -r bddf964880cf -r 45e550db32ab libpurple/prefs.h
--- a/libpurple/prefs.h	Wed Nov 07 13:49:26 2007 +0000
+++ b/libpurple/prefs.h	Wed Nov 07 13:49:48 2007 +0000
@@ -45,9 +45,20 @@
 } PurplePrefType;
 
 /**
- * Pref change callback type
+ * The type of callbacks for preference changes.
+ *
+ * @param name the name of the preference which has changed.
+ * @param type the type of the preferenced named @a name
+ * @param val  the new value of the preferencs; should be cast to the correct
+ *             type.  For instance, to recover the value of a #PURPLE_PREF_INT
+ *             preference, use <tt>GPOINTER_TO_INT(val)</tt>.  Alternatively,
+ *             just call purple_prefs_get_int(), purple_prefs_get_string_list()
+ *             etc.
+ * @param data Arbitrary data specified when the callback was connected with
+ *             purple_prefs_connect_callback().
+ *
+ * @see purple_prefs_connect_callback()
  */
-
 typedef void (*PurplePrefCallback) (const char *name, PurplePrefType type,
 		gconstpointer val, gpointer data);