comparison ChangeLog.API @ 21416:0f469b9a4302

propagate from branch 'im.pidgin.pidgin.next.minor' (head 58a7a68ec9891c7989ec16c0a3d52f9756de75db) to branch 'im.pidgin.cpw.resiak.disconnectreason' (head 5db9a4fc4ce0375558d343ab39f2b6f39453031b)

21278:ebb46dea479a

		* purple_plugin_disable(), which is intended to be called when
		  a purple_plugin_unload()--which was called when a user tried
		  to unload a plugin--fails.  This then prevents the plugin
		  from being saved in the saved plugins list, so it'll won't
		  be loaded at the next startup.
		* purple_util_init()
		* purple_util_uninit()

		* pidgin_dialogs_about_with_parent()
		* pidgin_log_show_contact_with_parent()

		  plugin's unload function and can actually return FALSE now.
		* purple_plugin_unload() no longer does its own notifications
		  when a dependent plugin fails to unload.  The UI should do
		  something appropriate.

		Deprecated:
		* pidgin_dialogs_about()
		* pidgin_log_show_contact()
		* pidgin_log_show()
		* pidgin_plugin_dialog_show()

		* purple_request_file()
		* purple_request_folder()
		* purple_request_input()
		* purple_request_ok_cancel()
		* purple_request_yes_no()

		MSN:
		* A new independant status type with PURPLE_STATUS_TUNE primitive, and
		  PURPLE_TUNE_ARTIST, PURPLE_TUNE_ALBUM and PURPLE_TUNE_TITLE
		  attributes.

21416:0f469b9a4302

		* purple_plugin_disable(), which is intended to be called when
		  a purple_plugin_unload()--which was called when a user tried
		  to unload a plugin--fails.  This then prevents the plugin
		  from being saved in the saved plugins list, so it'll won't
		  be loaded at the next startup.

		* PurpleDisconnectReason enumeration of machine-readable
		  types of connection error.
		* purple_connection_error_reason(), to be used by prpls
		  (instead of purple_connection_error() and setting
		  gc->wants_to_die) to report errors along with a
		  PurpleDisconnectReason.
		* PurpleConnectionUiOps.report_disconnect_reason, to be
		  implemented by UIs (rather than .report_disconnect) if
		  they want to use the reported PurpleDisconnectReason
		  to give a more specific error.
		* A connection-error signal, fired just after the UiOp is
		  called with the same information.
		* purple_connection_reason_is_fatal(), acting as a hint
		  to whether automatic reconnection should be attempted
		  after a connection error (rather than checking
		  gc->wants_to_die).
		* PurpleConnectionErrorInfo, 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
		  the last error without caching it themselves (as
		  PidginBuddyList does).
		* purple_account_clear_current_error() to reset an account's
		  error state to NULL.
		* An account-error-changed signal, firing when
		  purple_account_get_current_error()'s return value changes.

		* purple_util_init()
		* purple_util_uninit()

		* pidgin_dialogs_about_with_parent()
		* pidgin_log_show_contact_with_parent()

		  plugin's unload function and can actually return FALSE now.
		* purple_plugin_unload() no longer does its own notifications
		  when a dependent plugin fails to unload.  The UI should do
		  something appropriate.

		* pidgin_make_mini_dialog() now declares its return type to be
		  GtkWidget * rather than void *.  This should not break any
		  existing code since any code using it must already rely on
		  the return type actually being GtkWidget * all along.

		Deprecated:
		* pidgin_dialogs_about()
		* pidgin_log_show_contact()
		* pidgin_log_show()
		* pidgin_plugin_dialog_show()

		* purple_request_file()
		* purple_request_folder()
		* purple_request_input()
		* 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
		  attributes.