comparison src/blist.h @ 6720:41120df7ed94

[gaim-migrate @ 7247] Fixed documentation errors so Doxygen no longer complains. committer: Tailor Script <[e-mail]>

6719:3cc4d5e55a69

/**
 * Updates a buddy's warning level.
 *
 * @param buddy  The buddy whose warning level has changed
 * @param evil   The warning level as an int from 0 to 100 (or higher, I guess... but that'd be weird)
 */
void gaim_blist_update_buddy_evil(GaimBuddy *buddy, int warning);

/**
 * Updates a buddy's icon.

 *
 * The buddy will be inserted right after node or prepended to the
 * group if node is NULL.  If both are NULL, the buddy will be added to
 * the "Buddies" group.
 *
 * @param buddy  The new buddy who gets added
 * @param group  The group to add the new buddy to.
 * @param node   The insertion point
 */
void gaim_blist_add_buddy(GaimBuddy *buddy, GaimContact *contact, GaimGroup *group, GaimBlistNode *node);

/**
 * Creates a new group

GaimContact *gaim_find_contact(GaimGroup *group, const char *name);

/**
 * Finds a chat by name.
 *
 * @param name The chat's name.
 *
 * @return The chat, or @c NULL if the chat does not exist.
 */
GaimBlistChat *gaim_blist_find_chat(GaimAccount *account, const char *name);

/**
 * Returns a list of accounts that have buddies in this group
 *
 * @param group   The group
 * @return        A list of gaim_accounts
 */
GSList *gaim_group_get_accounts(GaimGroup *g);

/**
 * Determines whether an account owns any buddies in a given group
 *
 * @param g       The group to search through.
 * @param account The account.
 */
gboolean gaim_group_on_account(GaimGroup *g, GaimAccount *account);

/**
 * Called when an account gets signed on.  Tells the UI to update all the

char *gaim_group_get_setting(GaimGroup *g, const char *key);

/**
 * Associates some data with the chat in the xml buddy list
 *
 * @param b      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(GaimBlistChat *c, const char *key, const char *value);

/**
 * Retrieves data from the XML buddy list set by gaim_chat_set_setting())
 *
 * @param b      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(GaimBlistChat *c, const char *key);

/**

6720:41120df7ed94

/**
 * Updates a buddy's warning level.
 *
 * @param buddy   The buddy whose warning level has changed.
 * @param warning The warning level as an int from 0 to 100.
 */
void gaim_blist_update_buddy_evil(GaimBuddy *buddy, int warning);

/**
 * Updates a buddy's icon.

 *
 * The buddy will be inserted right after node or prepended to the
 * group if node is NULL.  If both are NULL, the buddy will be added to
 * the "Buddies" group.
 *
 * @param buddy   The new buddy who gets added
 * @param contact The optional contact to place the buddy in.
 * @param group   The group to add the new buddy to.
 * @param node    The insertion point
 */
void gaim_blist_add_buddy(GaimBuddy *buddy, GaimContact *contact, GaimGroup *group, GaimBlistNode *node);

/**
 * Creates a new group

GaimContact *gaim_find_contact(GaimGroup *group, const char *name);

/**
 * Finds a chat by name.
 *
 * @param account The chat's account.
 * @param name    The chat's name.
 *
 * @return The chat, or @c NULL if the chat does not exist.
 */
GaimBlistChat *gaim_blist_find_chat(GaimAccount *account, const char *name);

/**
 * Returns a list of accounts that have buddies in this group
 *
 * @param g The group
 *
 * @return A list of gaim_accounts
 */
GSList *gaim_group_get_accounts(GaimGroup *g);

/**
 * Determines whether an account owns any buddies in a given group
 *
 * @param g       The group to search through.
 * @param account The account.
 *
 * @return TRUE if there are any buddies in the group, or FALSE otherwise.
 */
gboolean gaim_group_on_account(GaimGroup *g, GaimAccount *account);

/**
 * Called when an account gets signed on.  Tells the UI to update all the

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(GaimBlistChat *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
 */
char *gaim_blist_chat_get_setting(GaimBlistChat *c, const char *key);

/**