comparison src/blist.h @ 9635:8ad07c6f6522

[gaim-migrate @ 10479] Keep the API docs in sync with my changes from last night. committer: Tailor Script <[e-mail]>

9634:10f1d729c415

/**
 * Returns the alias of a buddy.
 *
 * @param buddy   The buddy whose name will be returned.
 * @return        The alias (if set), server alias (if option is set), or NULL.
 */
const char *gaim_buddy_get_alias_only(GaimBuddy *buddy);


/**
 * Returns the correct name to display for a buddy, taking the contact alias
 * into account. In order of precedence: the buddy's alias; the buddy's
 * contact alias; the buddy's server alias; the buddy's user name.
 *
 * @param buddy  The buddy whose name will be returned
 * @return       The appropriate name or alias, or "Unknown"
 *
 */
const char *gaim_buddy_get_contact_alias(GaimBuddy *buddy);

 * Returns the correct name to display for a buddy. In order of precedence:
 * the buddy's alias; the buddy's server alias; the buddy's contact alias;
 * the buddy's user name.
 *
 * @param buddy   The buddy whose name will be returned.
 * @return        The appropriate name or alias, or "Unknown"
 */
const char *gaim_buddy_get_alias(GaimBuddy *buddy);

/**
 * Returns the correct name to display for a blist chat.

9635:8ad07c6f6522

/**
 * Returns the alias of a buddy.
 *
 * @param buddy   The buddy whose name will be returned.
 * @return        The alias (if set), server alias (if set and preference
 *                is to display server aliases), or NULL.
 */
const char *gaim_buddy_get_alias_only(GaimBuddy *buddy);


/**
 * Returns the correct name to display for a buddy, taking the contact alias
 * into account. In order of precedence: the buddy's alias; the buddy's
 * contact alias; the buddy's server alias; the buddy's user name.
 *
 * @param buddy  The buddy whose name will be returned
 * @return       The appropriate name or alias, or NULL.
 *
 */
const char *gaim_buddy_get_contact_alias(GaimBuddy *buddy);

 * Returns the correct name to display for a buddy. In order of precedence:
 * the buddy's alias; the buddy's server alias; the buddy's contact alias;
 * the buddy's user name.
 *
 * @param buddy   The buddy whose name will be returned.
 * @return        The appropriate name or alias, or NULL
 */
const char *gaim_buddy_get_alias(GaimBuddy *buddy);

/**
 * Returns the correct name to display for a blist chat.