Mercurial > pidgin
changeset 21375:50fa2c5a7029
Deprecate pidgin_blist_update_account_error_state() and
PidginBuddyList.connection_errors; update ChangeLog.API.
| author | Will Thompson <will.thompson@collabora.co.uk> |
|---|---|
| date | Sun, 28 Oct 2007 16:43:16 +0000 |
| parents | 71c1f2da4ff2 |
| children | f5b223d0cb89 |
| files | ChangeLog.API pidgin/gtkblist.h |
| diffstat | 2 files changed, 19 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/ChangeLog.API Sun Oct 28 16:32:37 2007 +0000 +++ b/ChangeLog.API Sun Oct 28 16:43:16 2007 +0000 @@ -32,6 +32,8 @@ to whether automatic reconnection should be attempted after a connection error (rather than checking gc->wants_to_die). + * PurpleConnectionErrorPair, a struct to hold a + PurpleConnectionError and a const char *description. * purple_account_get_current_error() to get the most recent PurpleConnectionError and description (or NULL if the account is happy with life), to allow bits of the UI to know @@ -109,6 +111,10 @@ * purple_request_ok_cancel() * purple_request_yes_no() + * purple_connection_error() + * pidgin_blist_update_account_error_state() + * PidginBuddyList.connection_errors + MSN: * A new independant status type with PURPLE_STATUS_TUNE primitive, and PURPLE_TUNE_ARTIST, PURPLE_TUNE_ALBUM and PURPLE_TUNE_TITLE
--- a/pidgin/gtkblist.h Sun Oct 28 16:32:37 2007 +0000 +++ b/pidgin/gtkblist.h Sun Oct 28 16:43:16 2007 +0000 @@ -84,7 +84,14 @@ GtkWidget *menutray; /**< The menu tray widget. */ GtkWidget *menutrayicon; /**< The menu tray icon. */ - GHashTable *connection_errors; /**< Caches connection error messages and accounts. */ + /** Caches connection error messages; keys are #PurpleAccount and + * values are non-@c NULL <tt>const char *</tt>s containing localised + * error messages. (If an account does not have an error, it will not + * appear in the table.) + * @deprecated in favour of purple_account_get_current_error(), which also + * gives you the #PurpleConnectionError value. + */ + GHashTable *connection_errors; guint refresh_timer; /**< The timer for refreshing every 30 seconds */ @@ -339,13 +346,16 @@ void pidgin_append_blist_node_extended_menu(GtkWidget *menu, PurpleBlistNode *node); /** - * Used by the connection API to tell the blist if an account - * has a connection error or no longer has a connection error. + * Was used by the connection API to tell the blist if an account has a + * connection error or no longer has a connection error, but the blist now does + * this itself with the @ref account-error-changed signal. * * @param account The account that either has a connection error * or no longer has a connection error. * @param message The connection error message, or NULL if this * account is no longer in an error state. + * @deprecated There was no good reason for code other than gtkconn to call + * this. */ void pidgin_blist_update_account_error_state(PurpleAccount *account, const char *message);