comparison src/blist.h @ 7125:208cb260d7a7

[gaim-migrate @ 7692] as long as we're pissing off plugin developers... committer: Tailor Script <[e-mail]>

7124:be4ca65b3b48

 * @param account    The account this chat will get added to
 * @param alias      The alias of the new chat
 * @param components The info the prpl needs to join the chat
 * @return           A newly allocated chat
 */
GaimChat *gaim_blist_chat_new(GaimAccount *account, const char *alias, GHashTable *components);

/**
 * Gets the alias of the chat, or the chat name if the alias does not exist
 *
 * @param chat    The chat
 * @return        The display name of the chat
 */
char *gaim_blist_chat_get_display_name(GaimChat *chat);

/**
 * Adds a new chat to the buddy list.
 *
 * The chat will be inserted right after node or appended to the end

 * Returns the correct name to display for a blist chat.
 *
 * @param chat   The chat whose name will be returned.
 * @return       The alias (if set), or first component value.
 */
const char *gaim_blist_chat_get_name(GaimChat *chat);

/**
 * Finds the buddy struct given a screenname and an account
 *
 * @param name    The buddy's screenname

 *
 * @param chat The chat.
 *
 * @return The parent group, or @c NULL if the chat is not in a group.
 */
GaimGroup *gaim_blist_chat_get_group(GaimChat *chat);

/**
 * Returns the group of which the buddy is a member.
 *
 * @param buddy   The buddy

 *
 * @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
 */
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_blist_chat_set_setting(GaimChat *c, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_blist_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
 */
char *gaim_blist_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 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
 */
char *gaim_buddy_get_setting(GaimBuddy *b, const char *key);

/*@}*/

/**************************************************************************/
/** @name UI Registration Functions                                       */

7125:208cb260d7a7

 * @param account    The account this chat will get added to
 * @param alias      The alias of the new chat
 * @param components The info the prpl needs to join the chat
 * @return           A newly allocated chat
 */
GaimChat *gaim_chat_new(GaimAccount *account, const char *alias, GHashTable *components);

/**
 * Gets the alias of the chat, or the chat name if the alias does not exist
 *
 * @param chat    The chat
 * @return        The display name of the chat
 */
char *gaim_chat_get_display_name(GaimChat *chat);

/**
 * Adds a new chat to the buddy list.
 *
 * The chat will be inserted right after node or appended to the end

 * Returns the correct name to display for a blist chat.
 *
 * @param chat   The chat whose name will be returned.
 * @return       The alias (if set), or first component value.
 */
const char *gaim_chat_get_name(GaimChat *chat);

/**
 * Finds the buddy struct given a screenname and an account
 *
 * @param name    The buddy's screenname

 *
 * @param chat The chat.
 *
 * @return The parent group, or @c NULL if the chat is not in a group.
 */
GaimGroup *gaim_chat_get_group(GaimChat *chat);

/**
 * Returns the group of which the buddy is a member.
 *
 * @param buddy   The buddy

 *
 * @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 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);

/*@}*/

/**************************************************************************/
/** @name UI Registration Functions                                       */