changeset 28945:f72c30e9ea61

Mark this function as deprecated because I really don't know what it's supposed to be used for
author Mark Doliner <mark@kingant.net>
date Wed, 03 Feb 2010 19:08:04 +0000
parents 7b6933cd7fd3
children 058fbbde85e2
files libpurple/prefs.h
diffstat 1 files changed, 10 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/libpurple/prefs.h	Wed Feb 03 16:05:28 2010 +0000
+++ b/libpurple/prefs.h	Wed Feb 03 19:08:04 2010 +0000
@@ -185,7 +185,17 @@
  *
  * @param name  The name of the pref
  * @param value The value to set
+ *
+ * @deprecatethis?
+ * @deprecated We're not really sure what purpose this function serves, so it
+ *             will be removed in 3.0.0.  Preferences values set using this
+ *             function aren't serialized to prefs.xml, which could be
+ *             misleading.  There is also no purple_prefs_get_generic, which
+ *             means that if you can't really get the value (other in a
+ *             connected callback).  If you think you have a use for this then
+ *             please let us know.
  */
+/* TODO: When this is removed, also remove struct purple_pref->value.generic */
 void purple_prefs_set_generic(const char *name, gpointer value);
 
 /**