comparison src/blist.h @ 12323:fc464a0abccc

[gaim-migrate @ 14627] Function prototypes need to be of the form foo(void); instead of foo(); for function that don't take any arguments. This allows the compiler to detect mistakes were someone passes arguments to such a function. committer: Tailor Script <[e-mail]>

12322:c7ae1fd0827d

/**
 * Creates a new buddy list
 *
 * @return The new buddy list.
 */
GaimBuddyList *gaim_blist_new();

/**
 * Sets the main buddy list.
 *
 * @param blist The buddy list you want to use.

GaimBlistNode *gaim_blist_node_next(GaimBlistNode *node, gboolean offline);

/**
 * Shows the buddy list, creating a new one if necessary.
 */
void gaim_blist_show();


/**
 * Destroys the buddy list window.
 */
void gaim_blist_destroy();

/**
 * Hides or unhides the buddy list.
 *
 * @param show   Whether or not to show the buddy list

/**
 * Creates a new contact
 *
 * @return       A new contact struct
 */
GaimContact *gaim_contact_new();

/**
 * Adds a new contact to the buddy list.
 *
 * The new contact will be inserted after insert or prepended to the list if

/****************************************************************************************/

/**
 * Loads the buddy list from ~/.gaim/blist.xml.
 */
void gaim_blist_load();

/**
 * Schedule a save of the blist.xml file.  This is used by the privacy
 * API whenever the privacy settings are changed.  If you make a change
 * to blist.xml using one of the functions in the buddy list API, then
 * the buddy list is saved automatically, so you should not need to
 * call this.
 */
void gaim_blist_schedule_save();

/**
 * Requests from the user information needed to add a buddy to the
 * buddy list.
 *

12323:fc464a0abccc

/**
 * Creates a new buddy list
 *
 * @return The new buddy list.
 */
GaimBuddyList *gaim_blist_new(void);

/**
 * Sets the main buddy list.
 *
 * @param blist The buddy list you want to use.

GaimBlistNode *gaim_blist_node_next(GaimBlistNode *node, gboolean offline);

/**
 * Shows the buddy list, creating a new one if necessary.
 */
void gaim_blist_show(void);


/**
 * Destroys the buddy list window.
 */
void gaim_blist_destroy(void);

/**
 * Hides or unhides the buddy list.
 *
 * @param show   Whether or not to show the buddy list

/**
 * Creates a new contact
 *
 * @return       A new contact struct
 */
GaimContact *gaim_contact_new(void);

/**
 * Adds a new contact to the buddy list.
 *
 * The new contact will be inserted after insert or prepended to the list if

/****************************************************************************************/

/**
 * Loads the buddy list from ~/.gaim/blist.xml.
 */
void gaim_blist_load(void);

/**
 * Schedule a save of the blist.xml file.  This is used by the privacy
 * API whenever the privacy settings are changed.  If you make a change
 * to blist.xml using one of the functions in the buddy list API, then
 * the buddy list is saved automatically, so you should not need to
 * call this.
 */
void gaim_blist_schedule_save(void);

/**
 * Requests from the user information needed to add a buddy to the
 * buddy list.
 *