comparison src/blist.h @ 7812:02cb9284782e

[gaim-migrate @ 8459] <datallah> faceprint: did you see the (beautiful) doxygen patch that i sent you a few days ago for blist.h ? <faceprint> datallah: i did <datallah> did you not like it? <faceprint> datallah: i suppose i'll apply it, since I have no idea what it does <aubin> lol <datallah> well.. run doxygen and see :) <datallah> its pretty <faceprint> i don't do doxygen <datallah> aha <faceprint> if I need to see documentation, I use vi <datallah> ... yeah yeah :) committer: Tailor Script <[e-mail]>

7811:2e6e269504a4

 * Associates some data with the group in the xml buddy list
 *
 * @param g      The group the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 */
void gaim_group_set_setting(GaimGroup *g, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_group_set_setting())
 *
 * @param g      The group to retrieve data from
 * @param key    The key to retrieve the data with
 * @return       The associated data or NULL if no data is associated
 */
const char *gaim_group_get_setting(GaimGroup *g, const char *key);

/**
 * Associates some data with the chat in the xml buddy list
 *
 * @param c      The chat the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 */
void gaim_chat_set_setting(GaimChat *c, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_chat_set_setting())
 *
 * @param c      The chat to retrieve data from
 * @param key    The key to retrieve the data with
 *
 * @return       The associated data or NULL if no data is associated
 */
const char *gaim_chat_get_setting(GaimChat *c, const char *key);

/**
 * Associates some data with the buddy in the xml buddy list
 *
 * @param b      The buddy the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 */
void gaim_buddy_set_setting(GaimBuddy *b, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_buddy_set_setting())
 *
 * @param b      The buddy to retrieve data from
 * @param key    The key to retrieve the data with
 * @return       The associated data or NULL if no data is associated
 */
const char *gaim_buddy_get_setting(GaimBuddy *b, const char *key);

/*@}*/

7812:02cb9284782e

 * Associates some data with the group in the xml buddy list
 *
 * @param g      The group the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 * @deprecated   Replaced by gaim_blist_node_set_bool(), gaim_blist_node_set_int()
 * 		 and gaim_blist_node_set_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
void gaim_group_set_setting(GaimGroup *g, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_group_set_setting())
 *
 * @param g      The group to retrieve data from
 * @param key    The key to retrieve the data with
 * @return       The associated data or NULL if no data is associated
 * @deprecated   Replaced by gaim_blist_node_get_bool(), gaim_blist_node_get_int()
 * 		 and gaim_blist_node_get_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
const char *gaim_group_get_setting(GaimGroup *g, const char *key);

/**
 * Associates some data with the chat in the xml buddy list
 *
 * @param c      The chat the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 * @deprecated   Replaced by gaim_blist_node_set_bool(), gaim_blist_node_set_int()
 * 		 and gaim_blist_node_set_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
void gaim_chat_set_setting(GaimChat *c, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_chat_set_setting())
 *
 * @param c      The chat to retrieve data from
 * @param key    The key to retrieve the data with
 *
 * @return       The associated data or NULL if no data is associated
 * @deprecated   Replaced by gaim_blist_node_get_bool(), gaim_blist_node_get_int()
 * 		 and gaim_blist_node_get_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
const char *gaim_chat_get_setting(GaimChat *c, const char *key);

/**
 * Associates some data with the buddy in the xml buddy list
 *
 * @param b      The buddy the data is associated with
 * @param key    The key used to retrieve the data
 * @param value  The data to set
 * @deprecated   Replaced by gaim_blist_node_set_bool(), gaim_blist_node_set_int()
 * 		 and gaim_blist_node_set_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
void gaim_buddy_set_setting(GaimBuddy *b, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_buddy_set_setting())
 *
 * @param b      The buddy to retrieve data from
 * @param key    The key to retrieve the data with
 * @return       The associated data or NULL if no data is associated
 * @deprecated   Replaced by gaim_blist_node_get_bool(), gaim_blist_node_get_int()
 * 		 and gaim_blist_node_get_string() to enable types and consolidate functionality.
 * 		 This function is scheduled to be removed in the near future.
 */
const char *gaim_buddy_get_setting(GaimBuddy *b, const char *key);

/*@}*/