ChangeLog.API

   1 Pidgin and Finch: The Pimpin' Penguin IM Clients That're Good for the Soul
   2
   3 This file intends to list all changes to libpurple, Pidgin, and Finch's public
   4 API. We sometimes forget to add changes to this file--sorry.
   5
   6 If your plugin fails to build with a new major version (e.g. 3.0.0) we
   7 suggest checking this list first, in case a function was simply renamed.
   8 You may still need to consult our API docs or our source code.
   9
  10 If you notice something missing from this list, please let us know and we'll
  11 add it.
  12
  13 version 3.0.0 (??/??/????):
  14         libpurple:
  15                 Added:
  16                 * displaying-emails-clear signal (notification signal)
  17                 * purple_account_is_disconnecting
  18                 * purple_account_get_ui_data
  19                 * purple_account_set_ui_data
  20                 * purple_account_privacy_get_denied
  21                 * purple_account_privacy_get_permitted
  22                 * PurpleAccountPresence and PurpleBuddyPresence inherit PurplePresence
  23                 * purple_account_presence_new
  24                 * purple_buddy_presence_new
  25                 * purple_account_register_completed
  26                 * PurpleAESCipher, PurpleDESCipher, PurpleDES3Cipher, PurpleHMACCipher,
  27                   PurplePBKDF2Cipher and PurpleRC4Cipher inherit PurpleCipher
  28                 * purple_aes_cipher_new
  29                 * purple_des3_cipher_new
  30                 * purple_des_cipher_new
  31                 * purple_hmac_cipher_new
  32                 * purple_pbkdf2_cipher_new
  33                 * purple_rc4_cipher_new
  34                 * purple_blist_node_is_transient
  35                 * purple_blist_node_set_transient
  36                 * purple_certificate_get_der_data
  37                 * purple_certificate_get_display_string
  38                 * purple_chat_user_get_alias
  39                 * purple_chat_user_get_chat
  40                 * purple_chat_user_get_flags
  41                 * purple_chat_user_is_buddy
  42                 * purple_chat_user_get_ui_data
  43                 * purple_chat_user_set_ui_data
  44                 * purple_chat_user_set_chat
  45                 * purple_connection_get_active_chats
  46                 * purple_connection_get_error_info
  47                 * purple_connection_get_flags
  48                 * purple_connection_set_flags
  49                 * purple_connection_update_last_received
  50                 * purple_conversation_get_ui_data
  51                 * purple_conversation_set_ui_data
  52                 * purple_conversation_message_get_alias
  53                 * purple_conversation_message_get_conv
  54                 * PurpleCountingNode, inherits PurpleBlistNode
  55                 * purple_counting_node_get_*
  56                 * purple_counting_node_change_*
  57                 * purple_counting_node_set_*
  58                 * PurpleHash and purple_hash_* API
  59                 * PurpleMD4Hash, PurpleMD5Hash, PurpleSHA1Hash and PurpleSHA265Hash
  60                   inherit PurpleHash
  61                 * purple_md4_hash_new
  62                 * purple_md5_hash_new
  63                 * purple_sha1_hash_new
  64                 * purple_sha256_hash_new
  65                 * PurpleIMConversation and PurpleChatConversation inherit
  66                   PurpleConversation
  67                 * purple_notify_emails_pending
  68                 * purple_notify_emails_present
  69                 * purple_notify_searchresult_column_get_title
  70                 * purple_notify_searchresult_column_is_visible
  71                 * purple_notify_searchresult_column_set_visible
  72                 * purple_notify_user_info_entry_destroy
  73                 * purple_notify_user_info_prepend_pair_plaintext
  74                 * purple_media_manager_enumerate_elements
  75                 * purple_menu_action_get_callback
  76                 * purple_menu_action_get_children
  77                 * purple_menu_action_get_data
  78                 * purple_menu_action_set_label
  79                 * purple_menu_action_set_data
  80                 * purple_menu_action_set_callback
  81                 * purple_menu_action_set_children
  82                 * PurplePluginInfoFlags (PURPLE_PLUGIN_INFO_FLAGS_INTERNAL and
  83                   PURPLE_PLUGIN_INFO_FLAGS_AUTO_LOAD)
  84                 * purple_plugin_get_dependent_plugins
  85                 * purple_plugin_get_filename
  86                 * purple_plugin_is_internal
  87                 * purple_plugin_info_new
  88                 * purple_plugin_get_info
  89                 * purple_plugin_info_get_abi_version
  90                 * purple_plugin_info_get_actions_cb
  91                 * purple_plugin_info_get_category
  92                 * purple_plugin_info_get_dependencies
  93                 * purple_plugin_info_get_error
  94                 * purple_plugin_info_get_extra_cb
  95                 * purple_plugin_info_get_flags
  96                 * purple_plugin_info_get_icon
  97                 * purple_plugin_info_get_license_id
  98                 * purple_plugin_info_get_license_text
  99                 * purple_plugin_info_get_license_url
 100                 * purple_plugin_info_get_pref_frame_cb
 101                 * purple_plugin_info_get_pref_request_cb
 102                 * purple_plugin_info_get_ui_data
 103                 * purple_plugin_info_set_ui_data
 104                 * purple_plugin_register_type
 105                 * purple_plugin_add_interface
 106                 * PURPLE_DEFINE_TYPE
 107                 * PURPLE_DEFINE_TYPE_EXTENDED
 108                 * PURPLE_IMPLEMENT_INTERFACE_STATIC
 109                 * PURPLE_IMPLEMENT_INTERFACE
 110                 * PURPLE_DEFINE_DYNAMIC_TYPE
 111                 * PURPLE_DEFINE_DYNAMIC_TYPE_EXTENDED
 112                 * PURPLE_IMPLEMENT_INTERFACE_DYNAMIC
 113                 * PURPLE_DEFINE_STATIC_TYPE
 114                 * PURPLE_DEFINE_STATIC_TYPE_EXTENDED
 115                 * PurpleProtocol, inherits GObject. Please see the documentation for
 116                   details.
 117                 * PurpleProtocolAction
 118                 * PurpleProtocolOverrideFlags
 119                 * PurpleProtocolClientIface
 120                 * PurpleProtocolServerIface
 121                 * PurpleProtocolIMIface
 122                 * PurpleProtocolChatIface
 123                 * PurpleProtocolPrivacyIface
 124                 * PurpleProtocolXferIface
 125                 * PurpleProtocolRoomlistIface
 126                 * PurpleProtocolAttentionIface
 127                 * PurpleProtocolMediaIface
 128                 * PurpleProtocolFactoryIface
 129                 * purple_protocol_get_* for PurpleProtocol members
 130                 * purple_protocol_class_* for class methods
 131                 * purple_protocol_client_iface_* for client interface methods
 132                 * purple_protocol_server_iface_* for server interface methods
 133                 * purple_protocol_im_iface_* for IM interface methods
 134                 * purple_protocol_chat_iface_* for chat interface methods
 135                 * purple_protocol_privacy_iface_* for privacy interface methods
 136                 * purple_protocol_xfer_iface_* for xfer interface methods
 137                 * purple_protocol_roomlist_iface_* for roomlist interface methods
 138                 * purple_protocol_attention_iface_* for attention interface methods
 139                 * purple_protocol_media_iface_* for media interface methods
 140                 * purple_protocol_factory_iface_* for factory interface methods
 141                 * purple_protocol_action_new
 142                 * purple_protocol_action_free
 143                 * purple_protocols_add
 144                 * purple_protocols_remove
 145                 * purple_protocols_find
 146                 * purple_protocols_get_all
 147                 * purple_protocols_get_handle
 148                 * purple_protocols_init
 149                 * purple_protocols_uninit
 150                 * purple_request_certificate
 151                 * purple_request_field_certificate_new
 152                 * purple_request_field_certificate_get_value
 153                 * purple_request_field_get_tooltip
 154                 * purple_request_field_group_get_fields_list
 155                 * purple_request_field_set_tooltip
 156                 * purple_request_fields_get_ui_data
 157                 * purple_request_fields_set_ui_data
 158                 * purple_roomlist_get_account
 159                 * purple_roomlist_get_proto_data
 160                 * purple_roomlist_get_ui_data
 161                 * purple_roomlist_room_get_expanded_once
 162                 * purple_roomlist_room_set_expanded_once
 163                 * purple_roomlist_set_proto_data
 164                 * purple_roomlist_set_ui_data
 165                 * purple_whiteboard_get_account
 166                 * purple_whiteboard_get_draw_list
 167                 * purple_whiteboard_set_draw_list
 168                 * purple_whiteboard_get_protocol_data
 169                 * purple_whiteboard_set_protocol_data
 170                 * purple_whiteboard_get_state
 171                 * purple_whiteboard_set_state
 172                 * purple_whiteboard_get_ui_data
 173                 * purple_whiteboard_set_ui_data
 174                 * purple_whiteboard_get_who
 175                 * purple_xfer_get_fd
 176                 * purple_xfer_get_message
 177                 * purple_xfer_get_protocol_data
 178                 * purple_xfer_get_ui_data
 179                 * purple_xfer_get_watcher
 180                 * purple_xfer_set_fd
 181                 * purple_xfer_set_local_port
 182                 * purple_xfer_set_protocol_data
 183                 * purple_xfer_set_remote_user
 184                 * purple_xfer_set_status
 185                 * purple_xfer_set_ui_data
 186                 * purple_xfer_set_watcher
 187                 * purple_xmlnode_get_default_namespace
 188                 * purple_xmlnode_strip_prefixes
 189
 190                 Changed:
 191                 * account.h has been split into account.h (PurpleAccount GObject) and
 192                   accounts.h (Accounts subsystem)
 193                 * blist.h has been split into buddylist.h (PurpleBuddyList and
 194                   subsystem), blistnode.h (PurpleBlistNode and PurpleCountingNode
 195                   GObjects), blistnodetypes (Buddy, Chat, Contact, Group GObjects)
 196                 * circbuffer.h renamed to circularbuffer.h
 197                 * conversation.h has been split into conversation.h
 198                   (PurpleConversation), conversationtypes.h (PurpleIMConversation and
 199                   PurpleChatConversation) and conversations.h (Conversations subsystem)
 200                 * Files in libpurple/ciphers have been renamed. To use a particular
 201                   cipher, include its header.
 202                 * Renamed ft.h file to xfer.h
 203                 * Renamed plugin.h file to plugins.h
 204                 * prpl.h has been split into protocol.h (PurpleProtocol GObject and
 205                   protocol interfaces) and protocols.h (protocols subsystem)
 206                 * status.h has been split into status.h (Status API) and presence.h
 207                   (Presence API)
 208                 * account-authorization-requested signal merged with
 209                   account-authorization-requested-with-message signal
 210                 * purple_account_add_buddy now takes an invite message as the last
 211                   parameter
 212                 * purple_account_add_buddies now takes an invite message as the last
 213                   parameter
 214                 * PurpleAccount is now a GObject. Please see the documentation for
 215                   details.
 216                 * purple_account_get_alias renamed to purple_account_get_private_alias
 217                 * purple_account_set_alias renamed to purple_account_set_private_alias
 218                 * purple_account_option_get_type renamed to
 219                   purple_account_option_get_pref_type
 220                 * PurplePrivacyType renamed to PurpleAccountPrivacyType
 221                 * purple_privacy_* functions are now purple_account_privacy_*
 222                 * Removed arguments local and restore from purple_account_privacy_allow
 223                   and purple_account_privacy_deny
 224                 * PurpleBlistNode is now a GObject. Please see the documentation for
 225                   details.
 226                 * purple_blist_alias_buddy renamed to purple_buddy_set_local_alias
 227                 * purple_blist_alias_chat renamed to purple_chat_set_alias
 228                 * purple_blist_alias_contact renamed to purple_contact_set_alias
 229                 * purple_blist_merge_contact renamed to purple_contact_merge
 230                 * purple_blist_rename_buddy renamed to purple_buddy_set_name
 231                 * purple_blist_rename_group renamed to purple_group_set_name
 232                 * purple_blist_server_alias_buddy renamed to
 233                 * purple_blist_update_buddy_status renamed to purple_buddy_update_status
 234                   purple_buddy_set_server_alias
 235                 * purple_buddy_get_local_buddy_alias renamed to
 236                   purple_buddy_get_local_alias
 237                 * PurpleContact and PurpleGroup inherit PurpleCountingNode
 238                 * PurpleBuddyList is now a GObject. Please see the documentation for
 239                   details.
 240                 * purple_find_buddies renamed to purple_blist_find_buddies
 241                 * purple_find_buddy_in_group renamed to purple_blist_find_buddy_in_group
 242                 * purple_find_buddy renamed to purple_blist_find_buddy
 243                 * purple_find_group renamed to purple_blist_find_group
 244                 * purple_get_blist renamed to purple_blist_get_buddy_list
 245                 * PurpleBuddyIconSpec has been moved to buddyicon.h
 246                 * purple_certificate_check_signature_chain now returns a list of failing
 247                   PurpleCertificate*s as the second parameter
 248                 * PurpleConversation is now an abstract type, and is a GObject. Please
 249                   see the documentation for details.
 250                 * purple_conv_* functions are now purple_conversation_*
 251                 * purple_conv_im_* functions are now purple_im_conversation_*
 252                 * purple_conv_chat_* functions are now purple_chat_conversation_*
 253                 * purple_chat_conversation_find_user renamed to
 254                   purple_chat_conversation_has_user
 255                 * PurpleTypingState renamed to PurpleIMTypingState
 256                 * PurpleConvChatBuddy changed to PurpleChatUser, is now a GObject.
 257                   Please see the documentation for details.
 258                 * purple_conv_chat_cb_* functions are now purple_chat_user_*
 259                 * Replaced 'chat-buddy' with 'chat-user' in conversation signals
 260                 * Replaced chatname, buddyname arguments of 'chat-user-flags' (formerly
 261                   'chat-buddy-flags') signal with PurpleChatUser *
 262                 * PurpleCipher split into PurpleCipher and PurpleHash, both are
 263                   GObjects. Please see the documentation for details.
 264                 * purple_cipher_context_* functions are now purple_cipher_*
 265                 * PurpleCircBuffer changed to PurpleCircularBuffer, is now a GObject.
 266                   Please see the documentation for details.
 267                 * purple_circ_buffer_* functions are now purple_circular_buffer_*
 268                 * purple_connection_error now takes a PurpleConnectionError
 269                   as the second parameter
 270                 * PurpleConnection is now a GObject. Please see the documentation for
 271                   details.
 272                 * PURPLE_CONNECTION_* prefix of PurpleConnectionFlag enum names changed
 273                   to PURPLE_CONNECTION_FLAG_*
 274                 * PURPLE_* prefix of PurpleConnectionState enum names changed to
 275                   PURPLE_CONNECTION_*
 276                 * purple_conversation_get_gc renamed to
 277                   purple_conversation_get_connection
 278                 * purple_dnsquery_a now takes a PurpleAccount as the first parameter
 279                 * PurpleIconScaleRules renamed to PurpleBuddyIconScaleFlags
 280                 * purple_imgstore_add renamed to purple_imgstore_new
 281                 * purple_imgstore_add_with_id renamed to purple_imgstore_new_with_id
 282                 * purple_network_listen now takes the protocol family as the second
 283                   parameter
 284                 * purple_network_listen now takes a boolean indicating external port
 285                   mapping as the fourth parameter
 286                 * purple_network_listen_range now takes a boolean indicating external
 287                   port mapping as the fifth parameter
 288                 * purple_network_listen_range now takes the protocol family as the
 289                   third parameter
 290                 * PurpleNotifyMsgType renamed to PurpleNotifyMessageType
 291                 * purple_notify_user_info_add_pair renamed to
 292                   purple_notify_user_info_add_pair_html
 293                 * purple_notify_user_info_get_entries returns a GQueue instead of
 294                   a GList
 295                 * purple_notify_user_info_entry_get_type renamed to
 296                   purple_notify_user_info_entry_get_entry_type
 297                 * purple_notify_user_info_entry_set_type renamed to
 298                   purple_notify_user_info_entry_set_entry_type
 299                 * purple_notify_user_info_prepend_pair renamed to
 300                   purple_notify_user_info_prepend_pair_html
 301                 * PurplePlugin is now a GObject (alias for GPluginPlugin). Please see
 302                   the documentation for details.
 303                 * PurplePluginInfo is now a GObject, inherits GPluginPluginInfo. Please
 304                   see the documentation for details.
 305                 * PurplePluginAction no longer has a context field. Use
 306                   PurpleProtocolAction for protocol actions.
 307                 * PURPLE_INIT_PLUGIN(pluginname, initfunc, plugininfo) is now
 308                   PURPLE_PLUGIN_INIT(pluginname, query_func, load_func, unload_func).
 309                   See "C Plugins tutorial" (tut_c_plugins.xml) for an example.
 310                 * purple_plugin_load and purple_plugin_unload now use an error argument
 311                   to return load/unload errors
 312                 * purple_plugins_get_all is now purple_plugins_find_all, and the
 313                   returned list of plugins MUST be free'd using g_list_free
 314                 * purple_plugin_get_* functions for plugin info are now
 315                   purple_plugin_info_get_*
 316                 * purple_plugin_get_author is now purple_plugin_info_get_authors, and
 317                   returns a NULL-terminated list of authors
 318                 * purple_plugins_probe is now purple_plugins_refresh
 319                 * purple_plugins_find_with_id renamed to purple_plugins_find_plugin
 320                 * purple_plugins_find_with_filename renamed to
 321                   purple_plugins_find_by_filename
 322                 * purple_plugin_pref_get_type renamed to
 323                   purple_plugin_pref_get_pref_type
 324                 * purple_plugin_pref_set_type renamed to
 325                   purple_plugin_pref_set_pref_type
 326                 * purple_prefs_get_type renamed to purple_prefs_get_pref_type
 327                 * proto_chat_entry has been renamed to PurpleProtocolChatEntry
 328                 * purple_proxy_info_get_type renamed to purple_proxy_info_get_proxy_type
 329                 * purple_proxy_info_set_type renamed to purple_proxy_info_set_proxy_type
 330                 * purple_request_field_get_type renamed to
 331                   purple_request_field_get_field_type
 332                 * PurpleRoomlist is now a GObject. Please see the documentation for
 333                   details.
 334                 * purple_roomlist_room_get_type is now
 335                   purple_roomlist_room_get_room_type
 336                 * purple_roomlist_field_get_type is now
 337                   purple_roomlist_field_get_field_type
 338                 * purple_savedstatus_get_type renamed to
 339                   purple_savedstatus_get_primitive_type
 340                 * purple_savedstatus_set_type renamed to
 341                   purple_savedstatus_set_primitive_type
 342                 * purple_savedstatus_substatus_get_type renamed to
 343                   purple_savedstatus_substatus_get_status_type
 344                 * serv_* functions are now purple_serv_*
 345                 * purple_srv_resolve now takes a PurpleAccount as the first parameter
 346                 * purple_srv_txt_query_get_type renamed to
 347                   purple_srv_txt_query_get_query_type
 348                 * PurpleStatus is now a GObject. Please see the documentation for
 349                   details.
 350                 * purple_status_attr_* functions are now purple_status_attribute_*
 351                 * PurpleStatusAttr renamed to PurpleStatusAttribute
 352                 * PurplePresence is now an abstract type, and is a GObject. Please see
 353                   the documentation for details.
 354                 * update_idle method has been added to PurplePresenceClass to update the
 355                   idle state of a presence
 356                 * StunCallback renamed to PurpleStunCallback
 357                 * purple_str_size_to_units now takes a goffset as the size parameter
 358                 * PTFunc renamed to PurpleThemeFunc
 359                 * purple_txt_resolve now takes a PurpleAccount as the first parameter
 360                 * UPnPMappingAddRemove renamed to PurpleUPnPMappingAddRemove
 361                 * purple_util_fetch_url_request now takes a PurpleAccount as
 362                   the first parameter
 363                 * purple_util_fetch_url_request now takes a length as the eighth
 364                   parameter
 365                 * purple_util_fetch_url_len now takes a length as the fifth parameter
 366                 * PurpleWhiteboard is now a GObject. Please see the documentation for
 367                   details.
 368                 * purple_value_destroy is now purple_value_free
 369                 * purple_value_new, purple_value_dup and purple_value_free now operate
 370                   on GValue instead of PurpleValue
 371                 * Signal registration now uses GTypes instead of PurpleValues.  See
 372                   SIGNAL-HOWTO for more information.
 373                 * purple_whiteboard_create renamed to purple_whiteboard_new
 374                 * purple_xfer_get_bytes_remaining now returns a goffset
 375                 * purple_xfer_get_bytes_sent now returns a goffset
 376                 * purple_xfer_get_size now returns a goffset
 377                 * purple_xfer_is_canceled renamed to purple_xfer_is_cancelled
 378                 * PurpleXfer is now a GObject. Please see the documentation for details.
 379                 * purple_xfer_get_type renamed to purple_xfer_get_xfer_type
 380                 * PurpleXferStatusType renamed to PurpleXferStatus
 381                 * PURPLE_XFER_* prefix of PurpleXferType enums changed to
 382                   PURPLE_XFER_TYPE_*
 383                 * purple_xfer_set_bytes_sent now takes a goffset as the bytes_sent
 384                   parameter
 385                 * purple_xfer_set_size now takes a goffset as the size parameter
 386                 * PurpleCertificateVerificationStatus enumeration is now merged with
 387                   internal flags, thus removing PURPLE_CERTIFICATE_INVALID and
 388                   replacing it with more precise errors.
 389                 * PurpleConnectionUiOps.report_disconnect now passes a
 390                   PurpleConnectionError as the second parameter
 391                 * PurpleXfer.bytes_remaining is now a goffset
 392                 * PurpleXfer.bytes_sent is now a goffset
 393                 * PurpleXfer.size is now a goffset
 394                 * PurpleCertificateScheme.get_times now uses gint64 instead of
 395                   time_t to represent times
 396                 * purple_certificate_get_times now uses gint64 instead of
 397                   time_t to represent times
 398                 * xmlnode renamed to PurpleXmlNode
 399                 * XMLNodeType renamed to PurpleXmlNodeType
 400                 * xmlnode_* functions are now purple_xmlnode_*
 401
 402                 Removed:
 403                 * buddy-added and buddy-removed blist signals
 404                 * privacy.h file
 405                 * value.h file
 406                 * _PurpleCipherBatchMode
 407                 * _PurpleCmdFlag
 408                 * _PurpleCmdPriority
 409                 * _PurpleCmdRet
 410                 * _PurpleCmdStatus
 411                 * _PurplePrefType
 412                 * _PurplePrivacyType
 413                 * _PurpleSoundEventID
 414                 * _XMLNodeType
 415                 * account-authorization-requested-with-message signal
 416                 * network-configuration-changed signal
 417                 * purple_account_add_buddies_with_invite
 418                 * purple_account_add_buddy_with_invite
 419                 * purple_account_set_current_error
 420                 * purple_blist_load
 421                 * purple_blist_new
 422                 * purple_set_blist
 423                 * purple_blist_update_buddy_icon
 424                 * purple_buddy_get_local_alias
 425                 * purple_buddy_icons_has_custom_icon
 426                 * purple_buddy_icons_find_custom_icon
 427                 * purple_buddy_icons_set_custom_icon
 428                 * purple_certificate_check_signature_chain_with_failing. Use
 429                   purple_certificate_check_signature_chain, instead
 430                 * purple_certificate_display_x509. Use purple_request_certificate,
 431                   instead
 432                 * PurpleCipherContext
 433                 * purple_cipher_context_destroy
 434                 * purple_cipher_context_get_data
 435                 * purple_cipher_context_get_option
 436                 * purple_cipher_context_new
 437                 * purple_cipher_context_new_by_name
 438                 * purple_cipher_context_set_data
 439                 * purple_cipher_context_set_option
 440                 * purple_cipher_get_capabilities
 441                 * purple_cipher_get_name
 442                 * PurpleCipherOps
 443                 * purple_ciphers_*
 444                 * PurpleCipher's init and uninit operations
 445                 * purple_connection_error_reason
 446                 * purple_connection_new
 447                 * purple_connection_new_unregister
 448                 * purple_connection_destroy
 449                 * purple_connection_set_account
 450                 * purple_contact_set_alias
 451                 * purple_conv_chat_set_users
 452                 * PurpleConversationType
 453                 * purple_core_migrate
 454                 * purple_dnsquery_a_account
 455                 * purple_network_listen_family. Use purple_network_listen, instead.
 456                 * purple_network_listen_map_external
 457                 * purple_network_listen_range_family. Use purple_network_listen,
 458                   instead.
 459                 * purple_network_ip_atoi
 460                 * purple_notify_searchresults_column_get_title
 461                 * purple_notify_searchresults_get_columns_count
 462                 * purple_notify_searchresults_get_rows_count
 463                 * purple_notify_searchresults_row_get
 464                 * PurplePluginType
 465                 * PurplePluginPriority
 466                 * PurplePluginLoaderInfo
 467                 * PurplePluginUiInfo
 468                 * purple_plugin_ipc_*
 469                 * purple_plugin_is_unloadable
 470                 * purple_plugin_new
 471                 * purple_plugin_probe
 472                 * purple_plugin_register
 473                 * purple_plugin_reload
 474                 * purple_plugins_destroy_all
 475                 * purple_plugins_enabled
 476                 * purple_plugins_find_with_basename
 477                 * purple_plugins_find_with_name
 478                 * purple_plugins_get_protocols
 479                 * purple_plugins_get_search_paths
 480                 * purple_plugins_register_load_notify_cb
 481                 * purple_plugins_register_probe_notify_cb
 482                 * purple_plugins_register_unload_notify_cb
 483                 * purple_plugins_unregister_load_notify_cb
 484                 * purple_plugins_unregister_probe_notify_cb
 485                 * purple_plugins_unregister_unload_notify_cb
 486                 * purple_plugins_unload
 487                 * purple_plugins_unload_all
 488                 * purple_pounces_load
 489                 * purple_prefs_set_generic
 490                 * purple_prefs_update_old
 491                 * purple_presence_add_status
 492                 * purple_presence_add_list
 493                 * PurplePresenceContext
 494                 * purple_presence_new
 495                 * purple_presence_new_for_account
 496                 * purple_presence_new_for_buddy
 497                 * PurplePluginProtocolInfo
 498                 * purple_proxy_connect_socks5
 499                 * purple_request_field_list_add
 500                 * purple_srv_cancel
 501                 * purple_srv_resolve_account
 502                 * purple_ssl_connect_fd
 503                 * purple_status_set_attr_boolean
 504                 * purple_status_set_attr_int
 505                 * purple_status_set_attr_string
 506                 * purple_status_type_add_attr
 507                 * purple_status_type_add_attrs
 508                 * purple_status_type_add_attrs_vargs
 509                 * purple_status_type_get_primary_attr
 510                 * purple_status_type_set_primary_attr
 511                 * purple_strlcat
 512                 * purple_strlcpy
 513                 * purple_txt_cancel
 514                 * purple_txt_resolve_account
 515                 * PurpleType, use GType instead.
 516                 * purple_util_fetch_url_len. Use purple_util_fetch_url, instead.
 517                 * purple_util_fetch_url_request_len. Use
 518                 * purple_util_fetch_url_request, instead.
 519                 * purple_util_fetch_url_request_len_with_account.  Use
 520                   purple_util_fetch_url_request, instead.
 521                 * purple_util_get_image_checksum.  Use
 522                   g_compute_checksum_for_data(G_CHECKSUM_SHA1, ...), instead.
 523                 * PurpleCertificateVerificationStatus.PURPLE_CERTIFICATE_INVALID
 524                 * PurpleConnectionUiOps.report_disconnect_reason
 525                 * PurplePluginProtocolInfo.add_buddy_with_invite
 526                 * PurplePluginProtocolInfo.add_buddies_with_invite
 527                 * PurplePluginProtocolInfo.get_cb_away
 528                 * PurpleValue, use GValue instead.
 529                 * serv_got_attention
 530                 * serv_send_attention
 531                 * struct _PurpleAttentionType
 532                 * struct _PurpleCipherCaps
 533                 * struct _PurpleConversation
 534                 * struct _PurpleConvChat
 535                 * struct _PurpleConvChatBuddy
 536                 * struct _PurpleConvIm
 537                 * struct _PurpleConvMessage
 538                 * struct _PurpleMenuAction
 539                 * struct _PurplePounce
 540                 * struct _PurpleProxyInfo
 541                 * struct _PurpleRequestField
 542                 * struct _PurpleRoomlist
 543                 * struct _PurpleRoomlistField
 544                 * struct _PurpleRoomlistRoom
 545                 * struct _PurpleWhiteboard
 546                 * struct PurpleAccountOption
 547                 * struct PurpleAccountUserSplit
 548                 * struct PurpleNotifySearchColumn
 549                 * wpurple_g_access
 550                 * xmlnode_set_attrib_with_namespace
 551                 * xmlnode_set_attrib_with_prefix
 552
 553         Pidgin:
 554                 Added:
 555                 * pidgin_create_webview
 556                 * PidginDockletFlag
 557                 * PidginPluginInfo, inherits PurplePluginInfo
 558                 * Various WebKit-related functions in gtkwebview.h
 559
 560                 Changed:
 561                 * gtkft.h file renamed to gtkxfer.h
 562                 * pidgin_blist_sort_method renamed to _PidginBlistSortMethod
 563                 * BRUSH_STATE_DOWN renamed to PIDGIN_BRUSH_STATE_DOWN
 564                 * BRUSH_STATE_MOTION renamed to PIDGIN_BRUSH_STATE_MOTION
 565                 * BRUSH_STATE_UP renamed to PIDGIN_BRUSH_STATE_UP
 566                 * DEFAULT_FONT_FACE renamed to PIDGIN_DEFAULT_FONT_FACE
 567                 * DndHintPosition renamed to PidginDndHintPosition
 568                 * DndHintWindowId renamed to PidginDndHintWindowId
 569                 * dnd_* functions renamed to pidgin_dnd_*
 570                 * FULL_CIRCLE_DEGREES renamed to PIDGIN_FULL_CIRCLE_DEGREES
 571                 * NUM_NICK_SEED_COLORS renamed to PIDGIN_NUM_NICK_SEED_COLORS
 572                 * PALETTE_NUM_COLORS renamed to PIDGIN_PALETTE_NUM_COLORS
 573                 * pidgin_new_item_from_stock renamed to pidgin_new_menu_item and
 574                   removed the accel related parameters.
 575                 * pidgin_setup_screenname_autocomplete now takes a filter function and
 576                   its data as final two arguments
 577                 * smiley_list renamed to PidginSmileyList
 578                 * smiley_parse_markup renamed to pidgin_smiley_parse_markup
 579                 * smiley_theme renamed to PidginSmileyTheme
 580                 * PidginWindow renamed to PidginConvWindow
 581
 582                 Removed:
 583                 * GtkIMHtml.clipboard_html_string
 584                 * GtkIMHtml.clipboard_text_string
 585                 * GtkIMHtmlFontDetail
 586                 * gtk_imhtml_animation_free
 587                 * gtk_imhtml_animation_new
 588                 * gtk_imhtml_image_add_to
 589                 * gtk_imhtml_image_free
 590                 * gtk_imhtml_image_new
 591                 * gtk_imhtml_image_scale
 592                 * pidgin_blist_update_account_error_state
 593                 * PidginBuddyList.connection_errors
 594                 * pidgin_check_if_dir
 595                 * PidginConversation.sg
 596                 * PIDGIN_DIALOG
 597                 * pidgin_dialogs_alias_contact
 598                 * pidgin_mini_dialog_links_supported
 599                 * pidgin_set_custom_buddy_icon
 600                 * pidgin_setup_screenname_autocomplete_with_filter
 601                 * struct _GtkIMHtmlAnimation
 602                 * struct _GtkIMHtmlFontDetail
 603                 * struct _GtkIMHtmlHr
 604                 * struct _GtkIMHtmlImage
 605                 * struct _GtkIMHtmlScalable
 606                 * struct _GtkSmileyTree
 607                 * struct _PidginChatPane
 608                 * struct _PidginImPane
 609
 610         Finch:
 611                 Added:
 612                 * FinchPluginInfo, inherits PurplePluginInfo
 613
 614                 Changed:
 615                 * gntft.h file renamed to gntxfer.h
 616                 * gnt_append_menu_action renamed to finch_append_menu_action
 617                 * gnt_ui_init renamed to finch_ui_init
 618                 * gnt_ui_uninit renamed to finch_ui_uninit
 619
 620         libgnt:
 621                 Changed:
 622                 * ENTRY_CHAR renamed to GNT_ENTRY_CHAR
 623                 * g_hash_table_duplicate renamed to gnt_hash_table_duplicate
 624                 * GDupFunc renamed to GntDuplicateFunc
 625
 626                 Removed:
 627                 * _GntFileType
 628                 * _GntKeyPressMode
 629                 * _GntMouseEvent
 630                 * _GntParamFlags
 631                 * _GntProgressBarOrientation
 632                 * _GntTreeColumnFlag
 633                 * _GntWidgetFlags
 634
 635 version 2.11.0:
 636         libpurple:
 637                 Added:
 638                 * account-status-changing signal (account signals)
 639                 * buddy-removed-from-group signal (blist signals)
 640                 * PurpleCommandsUiOps, to allow the UI to override the
 641                   built-in handling of commands.
 642                 * PurplePrefsUiOps, to allow the UI to override the way global
 643                   preferences are stored.
 644                 * PurpleAccountPrefsUiOps, to allow the UI to handle storage
 645                   of account preferences.
 646                 * purple_media_set_encryption_parameters
 647                 * purple_media_set_decryption_parameters
 648                 * purple_xfer_write_file
 649                 * purple_xfer_read_file
 650                 * purple_media_set_send_rtcp_mux
 651                 * purple_media_backend_set_send_rtcp_mux
 652
 653 version 2.10.12:
 654         * No changes
 655
 656 version 2.10.11:
 657         * No changes
 658
 659 version 2.10.10:
 660         * No changes
 661
 662 version 2.10.9:
 663         * No changes
 664
 665 version 2.10.8:
 666         * No changes
 667
 668 version 2.10.7:
 669         * No changes
 670
 671 version 2.10.6:
 672         * No changes
 673
 674 version 2.10.5:
 675         * No changes
 676
 677 version 2.10.4:
 678         * No changes
 679
 680 version 2.10.3:
 681         * No changes
 682
 683 version 2.10.2:
 684         * No changes
 685
 686 version 2.10.1:
 687         * No changes
 688
 689 version 2.10.0:
 690         libpurple:
 691                 Added:
 692                 * purple_srv_txt_query_destroy (accidentally left out of 2.8.0)
 693
 694         Pidgin:
 695                 Added:
 696                 * pidgin_dialogs_plugins_info (should not be used by anything but Pidgin)
 697
 698 version 2.9.0:
 699         libpurple:
 700                 Added:
 701                 * Hash table to PurpleConvChat struct, used to make
 702                   purple_conv_chat_cb_find O(1).
 703                 * ui_data pointer to PurpleConvChatBuddy struct.
 704                 * deleting-chat-buddy signal (conversation signals)
 705                 * pidgin_pixbuf_from_data
 706                 * pidgin_pixbuf_anim_from_data
 707                 * pidgin_pixbuf_new_from_file
 708                 * pidgin_pixbuf_new_from_file_at_size
 709                 * pidgin_pixbuf_new_from_file_at_scale
 710
 711                 Deprecated:
 712                 * purple_conv_chat_set_users
 713                 * PurpleConvChat in_room list
 714
 715 version 2.8.0 (06/07/2011):
 716         libpurple:
 717                 Added:
 718                 * account-authorization-requested-with-message signal (Stefan Ott)
 719                   (#8690)
 720                 * cleared-message-history signal (conversation signals)
 721                 * purple_account_add_buddy_with_invite
 722                 * purple_account_add_buddies_with_invite
 723                 * purple_dnsquery_a_account
 724                 * purple_notify_user_info_add_pair_plaintext
 725                 * purple_media_get_active_local_candidates
 726                 * purple_media_get_active_remote_candidates
 727                 * purple_media_manager_get_video_caps (Jakub Adam) (#13095)
 728                 * purple_media_manager_set_video_caps (Jakub Adam) (#13095)
 729                 * purple_pounce_destroy_all_by_buddy (Kartik Mohta) (#1131)
 730                 * purple_proxy_connect_socks5_account
 731                 * purple_srv_resolve_account
 732                 * purple_txt_resolve_account
 733                 * Added add_buddy_with_invite to PurplePluginProtocolInfo
 734                 * Added add_buddies_with_invite to PurplePluginProtocolInfo
 735                 * Added PurpleSrvTxtQueryUiOps which allow UIs to specify their
 736                   own mechanisms to resolve SRV and/or TXT queries. It works
 737                   similar to PurpleDnsQueryUiOps
 738                 * purple_marshal_BOOLEAN__POINTER_BOOLEAN (kawaii.neko) (#12599)
 739
 740                 Deprecated:
 741                 * purple_account_add_buddy
 742                 * purple_account_add_buddies_with_invite
 743                 * purple_dnsquery_a
 744                 * purple_proxy_connect_socks5
 745                 * purple_srv_resolve
 746                 * purple_txt_resolve
 747                 * add_buddy from PurplePluginProtocolInfo struct
 748                 * add_buddies from PurplePluginProtocolInfo struct
 749
 750         Pidgin:
 751                 Added:
 752                 * pidgin_make_scrollable (Gabriel Schulhof) (#10599)
 753                 * chat-nick-clicked signal (kawaii.neko) (#12599)
 754                 * chat-nick-autocomplete signal (kawaii.neko) (#12599)
 755
 756 version 2.7.11 (03/10/2011):
 757         * libpurple:
 758                 Added:
 759                 * Four entries in the GHashTable passed when joining
 760                   an XMPP chat room which allow the UI to request a limited
 761                   amount of history.  See XEP-0045 7.1.16 for details; the
 762                   entries are named history_maxchars, history_maxstanzas,
 763                   history_seconds, and history_since.  history_since must be
 764                   interpretable by purple_str_to_time, and the prpl takes care
 765                   of formatting the time properly.
 766         * Perl:
 767                 Added:
 768                 * Purple::find_conversation_with_account
 769                 * Purple::Conversation::Chat::send_with_flags
 770                 * Purple::Conversation::IM::send_with_flags
 771
 772 version 2.7.10 (02/06/2011):
 773         * No changes
 774
 775 version 2.7.9 (12/26/2010):
 776         * No changes
 777
 778 version 2.7.8 (12/19/2010):
 779         * No changes
 780
 781 version 2.7.7 (11/23/2010):
 782         * No changes
 783
 784 version 2.7.6 (11/21/2010):
 785         * No changes
 786
 787 version 2.7.5 (10/31/2010):
 788         * No changes
 789
 790 version 2.7.4 (10/20/2010):
 791         Perl:
 792                 Added:
 793                 * Purple::BuddyList::Chat::get_components
 794
 795                 Changed:
 796                 * Purple::BuddyList::Chat::new now works properly.  Thanks
 797                   to Rafael in devel@conference.pidgin.im for reporting and
 798                   testing.
 799
 800 version 2.7.3 (08/10/2010):
 801         libpurple:
 802                 Fixed:
 803                 * purple_account_[gs]et_public_alias no longer crash when
 804                   called for a protocol that doesn't support the underlying
 805                   calls and the caller does not specify a failure callback.
 806
 807         Perl:
 808                 Added:
 809                 * Exposed log-subsystem signals.
 810
 811         Pidgin:
 812                 Changed:
 813                 * Changing the visibility (gtk_widget_hide/show) of
 814                   the widgets in the GtkIMHtmlToolbar should now affect
 815                   the visibility of the entries in the 'lean' view
 816                   (the default toolbar view).
 817
 818                 Deprecated:
 819                 * pidgin_check_if_dir
 820
 821         libgnt:
 822                 Added:
 823                 * gnt_tree_row_get_key, gnt_tree_row_get_next,
 824                   gnt_tree_row_get_prev, gnt_tree_row_get_child and
 825                   gnt_tree_row_get_parent.
 826
 827 version 2.7.2 (07/21/2010):
 828         * No changes
 829
 830 version 2.7.1 (05/29/2010):
 831         * No changes
 832
 833 version 2.7.0 (05/12/2010):
 834         libpurple:
 835                 Added:
 836                 * Account signals (see account-signals.dox); useful for D-Bus
 837                    * account-signed-on
 838                    * account-signed-off
 839                    * account-connection-error
 840                 * purple_account_get_name_for_display
 841                 * purple_account_get_privacy_type
 842                 * purple_account_get_public_alias
 843                 * purple_account_set_privacy_type
 844                 * purple_account_set_public_alias
 845                 * buddy-caps-changed blist signal
 846                 * Added media_caps to the PurpleBuddy struct
 847                 * purple_buddy_get_media_caps
 848                 * purple_buddy_set_media_caps
 849                 * purple_certificates_import for importing multiple
 850                   certificates from a single file (and corresponding
 851                   import_certificates member of PurpleCertificateScheme struct)
 852                 * autojoin connection signal
 853                 * purple_contact_get_group
 854                 * sent-attention conversation signal
 855                 * got-attention conversation signal
 856                 * ui-caps-changed media manager signal
 857                 * purple_media_candidate_copy
 858                 * purple_media_codec_copy
 859                 * purple_media_manager_get_backend_type
 860                 * purple_media_manager_set_backend_type
 861                 * PurpleMood struct in status.h
 862                 * purple_network_get_all_local_system_ips, which returns all
 863                   local IPs on the system.  On systems with the getifaddrs()
 864                   function, this will return both IPv4 and IPv6 addresses
 865                   (excluding link-local and loopback addresses).  On others,
 866                   it returns just IPv4 addresses.
 867                 * purple_network_listen_family and
 868                   purple_network_listen_range_family.  These will replace the
 869                   versions without _family in 3.0.0 and allow the caller to
 870                   specifically request either an IPv4 or IPv6 socket.  IPv6 is
 871                   only supported if the getaddrinfo() function is available
 872                   at build-time (not the case on Windows, currently).
 873                 * purple_prpl_got_media_caps
 874                 * purple_request_action_with_icon
 875                 * purple_request_action_with_icon_varg
 876                 * purple_socket_get_family
 877                 * purple_socket_speaks_ipv4
 878                 * purple_unescape_text
 879                 * purple_uuid_random
 880                 * purple_xfer_get_thumbnail
 881                 * purple_xfer_get_thumbnail_mimetype
 882                 * purple_xfer_set_thumbnail
 883                 * purple_xfer_prepare_thumbnail
 884
 885         Pidgin:
 886                 Added:
 887                 * pidgin_dialogs_buildinfo (should not be used by anything but Pidgin)
 888                 * pidgin_dialogs_developers (should not be used by anything but Pidgin)
 889                 * pidgin_dialogs_translators (should not be used by anything but Pidgin)
 890                 * gtk_imhtmltoolbar_switch_active_conversation
 891                 * 'paste' signal for GtkIMHtml (more in gtkimhtml-signals.dox)
 892                 * 'drawing-buddy' signal for gtkblist (more in gtkblist-signals.dox)
 893
 894 version 2.6.6 (02/18/2010):
 895         libpurple:
 896                 Changed:
 897                 * purple_xfer_cancel_local is now called instead of
 898                   purple_xfer_request_denied if an error is found when selecting
 899                   a file to send. Request denied is still used when a receive
 900                   request is not allowed.
 901                 * xmlnode_from_str now properly handles parsing an attribute which
 902                   contain "&lt;br&gt;", which were previously transformed into a
 903                   newline character (libxml2 unescapes all entities except
 904                   representations of '&', and libpurple's purple_unescape_html
 905                   converts "<br>" to a newline).
 906
 907         Perl:
 908                 Changed:
 909                 * Corrected the package names for the PurpleProxyType and
 910                   PurpleLogReadFlags enums to have the correct number of colons
 911                   (from Purple::ProxyType::::<type> to Purple::ProxyType::<type>
 912                   and Purple::Log:ReadFlags::::<type> to
 913                   Purple::Log::ReadFlags::<type>)  (Chris Foote)
 914
 915 version 2.6.5 (01/08/2010):
 916         No changes
 917
 918 version 2.6.4 (11/29/2009):
 919         No changes
 920
 921 version 2.6.3 (10/16/2009):
 922         No changes
 923
 924 version 2.6.2 (09/05/2009):
 925         Perl:
 926                 Added:
 927                 * Purple::XMLNode::get_next(), which returns the next neighbor tag of
 928                   the current node.
 929                 Changed:
 930                 * Purple::XMLNode::get_child() will return the first child node if
 931                   passed "" or undef as the name of the node.
 932
 933 version 2.6.1 (08/18/2009):
 934         No changes
 935
 936 version 2.6.0 (08/18/2009):
 937         libpurple:
 938                 Added:
 939                 * PurpleMedia and PurpleMediaManager API
 940                 * PURPLE_BLIST_NODE
 941                 * PURPLE_GROUP
 942                 * PURPLE_CONTACT
 943                 * PURPLE_BUDDY
 944                 * PURPLE_CHAT
 945                 * Account signals (see account-signals.dox)
 946                         * account-actions-changed
 947                         * account-created
 948                         * account-destroying
 949                 * blist-node-added and blist-node-removed signals (see
 950                   blist-signals.dox)
 951                 * Three Blist UI ops used to overload libpurple's built-in saving
 952                   of the buddy list to blist.xml. If a UI implements these, it probably
 953                   wants to add the buddies itself and not call purple_blist_load.
 954                 * Three File Transfer UI ops used to overload libpurple's use of fread
 955                   and fwrite for saving a file locally. These allow a UI to stream a
 956                   file through a socket without buffering the file on the local disk.
 957                 * Jabber plugin signals (see jabber-signals.dox)
 958                 * purple_account_remove_setting
 959                 * purple_buddy_destroy
 960                 * purple_buddy_get_protocol_data
 961                 * purple_buddy_set_protocol_data
 962                 * purple_buddy_get_local_buddy_alias
 963                 * purple_blist_get_buddies
 964                 * purple_blist_get_ui_data
 965                 * purple_blist_set_ui_data
 966                 * purple_blist_node_get_ui_data
 967                 * purple_blist_node_set_ui_data
 968                 * purple_certificate_check_signature_chain_with_failing
 969                 * purple_chat_destroy
 970                 * purple_connection_get_protocol_data
 971                 * purple_connection_set_protocol_data
 972                 * purple_contact_destroy
 973                 * purple_conv_chat_invite_user
 974                 * purple_debug_is_unsafe
 975                 * purple_debug_is_verbose
 976                 * purple_debug_set_unsafe
 977                 * purple_debug_set_verbose
 978                 * purple_global_proxy_set_info
 979                 * purple_group_destroy
 980                 * purple_ipv4_address_is_valid
 981                 * purple_ipv6_address_is_valid
 982                 * purple_log_get_activity_score
 983                 * purple_markup_is_rtl
 984                 * purple_markup_escape_text
 985                 * purple_network_convert_idn_to_ascii
 986                 * purple_network_force_online
 987                 * purple_network_set_stun_server
 988                 * purple_network_set_turn_server
 989                 * purple_network_get_stun_ip
 990                 * purple_network_get_turn_ip
 991                 * purple_network_remove_port_mapping
 992                 * purple_plugins_get_search_paths
 993                 * purple_proxy_connect_udp
 994                 * purple_prpl_get_media_caps
 995                 * purple_prpl_got_account_actions
 996                 * purple_prpl_initiate_media
 997                 * purple_request_field_get_group
 998                 * purple_request_field_get_ui_data
 999                 * purple_request_field_set_ui_data
1000                 * purple_ssl_connect_with_ssl_cn
1001                 * purple_strequal
1002                 * purple_utf8_strip_unprintables
1003                 * purple_util_fetch_url_request_len_with_account
1004                 * purple_xfer_prpl_ready
1005                 * purple_xfer_ui_ready
1006                 * xmlnode_from_file
1007                 * xmlnode_get_parent
1008                 * xmlnode_set_attrib_full
1009                 * PURPLE_STATUS_MOOD as a new PurpleStatusPrimitive
1010
1011                 Changed:
1012                 * xmlnode_remove_attrib now removes all attributes with the
1013                   same name.  Previously, it would remove the first one found,
1014                   which was completely non-deterministic.  If you want to remove
1015                   the attribute with no namespace, then use NULL with
1016                   xmlnode_remove_with_namespace.
1017                 * Plugins may now emit the jabber-sending-xmlnode signal in order
1018                   to send stanzas; this method is preferred to the prpl send_raw
1019                   function as other plugins listening to the signal see them.
1020                 * The conversation-updated signal with a PURPLE_CONV_UPDATE_TYPING
1021                   update type is emitted when receiving an IM.  Previously, the
1022                   typing state was modified (and the buddy-typing-stopped signal
1023                   emitted), but this signal was not emitted.
1024                 * Added a client_type field in the get_ui_info core UI op. See
1025                   core.h for details.
1026                 * Added introspection of signals exposed via the D-Bus API.
1027                 * purple_find_buddies is now more efficient in the case where
1028                   it is enumerating all the buddies for an account.
1029                 * purple_find_group is now more efficient for large numbers of groups.
1030                 * purple_find_conversation_with_account is more efficient for large
1031                   numbers of concurrent conversations.
1032                 * All DNS routines support internationalized domain names (IDNs) when
1033                   libpurple is compiled with GNU libidn.
1034                 * status is set before emitting signals in purple_xfer_set_status.
1035                 * Creating multiple distinct chats with the same name (i.e. "MSN Chat")
1036                   is deprecated and will be removed in libpurple 3.0.0.
1037                 * purple_xfer_start now accepts -1 as the fd parameter if the protocol
1038                   plugin will administer the transfer itself. 0 is still accepted for
1039                   backward compatibility since older versions of libpurple will not
1040                   accept -1.
1041
1042                 Deprecated:
1043                 * buddy-added and buddy-removed blist signals
1044                 * purple_blist_destroy
1045                 * purple_blist_new
1046                 * purple_buddy_get_local_alias
1047                 * purple_certificate_check_signature_chain
1048                 * purple_ip_address_is_valid
1049                 * purple_notify_user_info_remove_entry
1050                 * purple_set_blist
1051                 * purple_status_type_set_primary_attr
1052                 * purple_status_type_add_attr
1053                 * purple_status_type_add_attrs
1054                 * purple_status_type_add_attrs_vargs
1055                 * purple_status_type_get_primary_attr
1056                 * purple_status_set_attr_boolean
1057                 * purple_status_set_attr_int
1058                 * purple_status_set_attr_string
1059                 * purple_presence_add_status
1060                 * purple_presence_add_list
1061                 * purple_util_fetch_url_request_len
1062                 * xmlnode_set_attrib_with_namespace
1063                 * xmlnode_set_attrib_with_prefix
1064
1065         pidgin:
1066                 Added:
1067                 * gtk_imhtml_class_register_protocol
1068                 * gtk_imhtml_link_get_url, gtk_imhtml_link_get_text_tag,
1069                   gtk_imhtml_link_activate functions to process GtkIMHtmlLink
1070                   objects from GtkIMHtml protocol callbacks.
1071                 * gtk_imhtml_set_return_inserts_newline
1072                 * gtk_imhtml_set_populate_primary_clipboard
1073                 * pidgin_blist_set_theme
1074                 * pidgin_blist_get_theme
1075                 * pidgin_prefs_labeled_password
1076                 * pidgin_smiley_editor_set_data
1077                 * pidgin_sound_is_customized
1078                 * pidgin_utils_init, pidgin_utils_uninit
1079                 * pidgin_notify_pounce_add
1080                 * PidginBlistTheme, PidginBlistThemeLoader API
1081                 * PidginIconTheme, PidginStatusIconTheme, PidginIconThemeLoader
1082                   API
1083                 * pidgin_stock_id_from_status_primitive
1084                 * pidgin_stock_id_from_presence
1085
1086         libgnt:
1087                 Added:
1088                 * GntProgressBar and functions (Saleem Abdulrasool)
1089
1090         perl:
1091                 Added:
1092                 * Purple::XMLNode::get_name()
1093
1094                 Changed:
1095                 * Made a bunch of functions act more perl-like. Call the new()
1096                   functions as Class->new(...) instead of Class::new(...):
1097                         * Purple::Request::Fields::new
1098                         * Purple::Request::Field::new
1099                         * Purple::Request::Field::account_new
1100                         * Purple::Request::Field::bool_new
1101                         * Purple::Request::Field::choice_new
1102                         * Purple::Request::Field::int_new
1103                         * Purple::Request::Field::label_new
1104                         * Purple::Request::Field::list_new
1105                         * Purple::Request::Field::string_new
1106                         * Purple::Request::Field::group_new
1107                 * Make the XMLNode API more perl-like. Don't pass len
1108                   parameters and call them like:
1109                         * $xmlnode->copy()
1110                         * $xmlnode->to_str()
1111                         * $xmlnode->to_formatted_str()
1112                         * Purple::XMLNode::from_str(...)
1113 version 2.5.9 (08/18/2009):
1114         No changes
1115
1116 version 2.5.8 (06/27/2009):
1117         No changes
1118
1119 version 2.5.7 (06/20/2009):
1120         No changes
1121
1122 version 2.5.6 (05/19/2009):
1123         No changes
1124
1125 version 2.5.5 (03/01/2009):
1126         libpurple:
1127                 Changed:
1128                 * purple_status_type_new now defaults "saveable" to TRUE.
1129                   This was necessary in order to maintain the current behavior
1130                   while fixing non-saveable statuses not to be saved.
1131                 * xmlnode_get_prefix, xmlnode_to_str and xmlnode_to_formatted_str
1132                   now all take a const xmlnode* instead of an xmlnode*
1133
1134 version 2.5.4 (01/12/2009):
1135         perl:
1136                 Changed:
1137                 * Purple::PluginPref->get_bounds no longer takes two integer
1138                   arguments it now returns two integers.
1139
1140                 Removed:
1141                 * Removed a handful of string-related utility functions that
1142                   can generally be better handled with perl's built-in string
1143                   functions rather than using pidgin's:
1144                         * Purple::Util::strcasereplace
1145                         * Purple::Util::strcasestr
1146                         * Purple::Util::strreplace
1147                         * Purple::Util::str_strip_char
1148                         * Purple::Util::chrreplace
1149
1150 version 2.5.3 (12/20/2008):
1151         libpurple
1152                 Changed:
1153                 * purple_util_fetch_url and purple_util_fetch_url_request can
1154                   now fetch https URLs
1155
1156 version 2.5.0 (08/18/2008):
1157         libpurple:
1158                 Added:
1159                 * Connection flag PURPLE_CONNECTION_ALLOW_CUSTOM_SMILEY to indicate
1160                   that the connection supports sending and receiving custom smileys.
1161                 * PurpleSmiley and the Smiley API.
1162                 * purple_serv_got_join_chat_failed
1163                 * chat-join-failed signal (see conversation-signals.dox)
1164                 * chat-invite-blocked and blocked-im-msg signals (see
1165                   converation-signals.dox) (Thanks to Stefan Ott)
1166                 * purple_blist_update_node_icon
1167                 * purple_buddy_icons_node_has_custom_icon
1168                 * purple_buddy_icons_node_find_custom_icon
1169                 * purple_buddy_icons_node_set_custom_icon
1170                 * purple_buddy_icons_node_set_custom_icon_from_file
1171                 * purple_notify_user_info_prepend_section_break
1172                 * purple_notify_user_info_prepend_section_header
1173                 * "website" and "dev_website" items to the ui_info hash table
1174                 * purple_cmds_get_handle, purple_cmds_init, purple_cmds_uninit
1175                 * cmd-added and cmd-removed signals
1176                 * purple_get_host_name
1177                 * purple_util_fetch_url_len (temporary function overload to add max_len param)
1178                 * purple_util_fetch_url_request_len
1179                 * purple_prpl_send_attention
1180                 * purple_prpl_got_attention
1181                 * purple_prpl_got_attention_in_chat
1182
1183                 Deprecated:
1184                 * purple_blist_update_buddy_icon
1185                 * purple_buddy_icons_has_custom_icon
1186                 * purple_buddy_icons_find_custom_icon
1187                 * purple_buddy_icons_set_custom_icon
1188                 * pidgin_set_custom_buddy_icon
1189                 * purple_util_fetch_url_len
1190                 * purple_util_fetch_url_request_len
1191                 * serv_send_attention
1192                 * serv_got_attention
1193
1194                 Changed:
1195                 * xmlnode_copy now copies the prefix and namespace map for nodes.
1196
1197         pidgin:
1198                 Added:
1199                 * gtk_imhtml_smiley_create, gtk_imhtml_smiley_reload and
1200                   gtk_imhtml_smiley_destroy to deal with GtkIMHtmlSmiley's.
1201                 * pidgin_pixbuf_from_imgstore to create a GdkPixbuf from a
1202                   PurpleStoredImage.
1203                 * pidgin_themes_smiley_themeize_custom to associate custom smileys to
1204                   a GtkIMHtml widget.
1205                 * GTK_IMHTML_CUSTOM_SMILEY flag for GtkIMHtml.
1206                 * GTK+ Custom Smiley API.
1207
1208 version 2.4.2 (05/17/2008):
1209         perl:
1210                 Added:
1211                 * Purple::Prefs::get_children_names.
1212                 * Purple::timeout_remove.
1213                 Changed:
1214                 * Purple::timeout_add now returns a handle which can be used
1215                   to remove the timeout.
1216                 * Callbacks to Purple::Util::fetch_url and the
1217                   Purple::Request::* functions can now be specified as both
1218                   strings (the name of the callback function) and as coderefs.
1219         Finch:
1220                 libgnt:
1221                 * Added gnt_bindable_check_key to check if a keystroke is bound.
1222
1223 version 2.4.0 (02/29/2008):
1224         libpurple:
1225                 Added:
1226                 * purple_certificate_add_ca_search_path. (Florian Quèze)
1227                 * purple_gai_strerror.
1228                 * purple_major_version, purple_minor_version,
1229                   purple_micro_version variables are exported by version.h,
1230                   giving the version of libpurple in use at runtime.
1231                 * purple_util_set_current_song, purple_util_format_song_info
1232                 * purple_ip_address_is_valid
1233                 * Some accessor functions to the Roomlist API:
1234                         * purple_roomlist_get_fields
1235                         * purple_roomlist_room_get_type
1236                         * purple_roomlist_room_get_name
1237                         * purple_roomlist_room_get_parent
1238                         * purple_roomlist_room_get_fields
1239                         * purple_roomlist_field_get_type
1240                         * purple_roomlist_field_get_label
1241                         * purple_roomlist_field_get_hidden
1242                 * unlocalized_name field in PurpleAttentionType for UIs that need it.
1243                 * Some accessor and mutator functions for PurpleAttentionType:
1244                         * purple_attention_type_set_name
1245                         * purple_attention_type_set_incoming_desc
1246                         * purple_attention_type_set_outgoing_desc
1247                         * purple_attention_type_set_icon_name
1248                         * purple_attention_type_set_unlocalized_name
1249                         * purple_attention_type_get_name
1250                         * purple_attention_type_get_incoming_desc
1251                         * purple_attention_type_get_outgoing_desc
1252                         * purple_attention_type_get_icon_name
1253                         * purple_attention_type_get_unlocalized_name
1254                 * Add some PurpleBuddyListNode accessor functions:
1255                         * purple_blist_node_get_parent
1256                         * purple_blist_node_get_first_child
1257                         * purple_blist_node_get_sibling_next
1258                         * purple_blist_node_get_sibling_prev
1259                 * Added last_received to PurpleConnection, the time_t of the
1260                   last received packet.
1261                 * Added some more accessor functions:
1262                         * purple_chat_get_account
1263                         * purple_chat_get_components
1264                         * purple_connection_get_prpl
1265                         * purple_xfer_get_start_time
1266                         * purple_xfer_get_end_time
1267                 * purple_serv_got_private_alias for prpls to call after receiving a
1268                   private alias from the server.
1269
1270         Pidgin:
1271                 Added:
1272                 * pidgin_create_dialog to create a window that closes on escape. Also
1273                   added utility functions pidgin_dialog_get_vbox_with_properties,
1274                   pidgin_dialog_get_vbox, pidgin_dialog_get_action_area to access the
1275                   contents in the created dialog. (Peter 'fmoo' Ruibal)
1276                 * pidgin_dialog_add_button to add buttons to a dialog created by
1277                   pidgin_create_dialog.
1278                 * GTK_IMHTML_NO_SMILEY for GtkIMHtmlOptions means not to look for
1279                   smileys in the text. (Florian 'goutnet' Delizy)
1280                 * pidgin_auto_parent_window to make a window transient for a suitable
1281                   parent window.
1282                 * pidgin_tooltip_setup_for_treeview, pidgin_tooltip_destroy,
1283                   pidgin_tooltip_show and pidgin_tooltip_setup_for_widget to simplify
1284                   the process of drawing tooltips.
1285                 * pidgin_add_widget_to_vbox to simplify adding a labeled widget to a
1286                   window.
1287
1288                 Deprecated:
1289                 * PIDGIN_DIALOG
1290
1291         Finch:
1292                 * finch_roomlist_get_ui_ops and finch_roomlist_show_all
1293                 * finch_request_field_get_widget to get the widget for a request
1294                   field.
1295                 * finch_blist_get_tree to get the GntTree widget representing the
1296                   buddy list.
1297                 * FinchBlistManager structure to manage the buddylist view, and some
1298                   util functions finch_blist_install_manager,
1299                   finch_blist_uninstall_manager, finch_blist_manager_find and
1300                   finch_blist_manager_add_node.
1301                 * Added finch_log_show, finch_log_show_contact, finch_syslog_show,
1302                   finch_log_init, finch_log_get_handle, finch_log_uninit
1303
1304                 libgnt:
1305                 * Added gnt_tree_set_row_color to set the color for a row in a tree.
1306                 * Added gnt_style_get_string_list
1307                 * Added gnt_color_add_pair to define a new color.
1308                 * Added gnt_colors_get_color to get an ncurses color value from a
1309                   string.
1310                 * Added gnt_style_get_color to get a color pair from an entry in
1311                   ~/.gntrc
1312                 * Added gnt_tree_get_parent_key to get the key for the parent row.
1313
1314 version 2.3.0 (11/24/2007):
1315         libpurple:
1316                 Added:
1317                 * a PurpleConversation field and an alias field in PurpleConvMessage
1318                 * account-authorization signals (see account-signals.dox for
1319                   details) (Stefan Ott)
1320                 * libpurple/purple.h, which includes #define's and #include's
1321                   required to compile stand-alone plugins
1322                 * PURPLE_STATUS_TUNE as a new PurpleStatusPrimitive
1323                 * purple_plugin_disable(), which is intended to be called when
1324                   a purple_plugin_unload()--which was called when a user tried
1325                   to unload a plugin--fails.  This then prevents the plugin
1326                   from being saved in the saved plugins list, so it'll won't
1327                   be loaded at the next startup.
1328                 * PurpleDisconnectReason enumeration of machine-readable
1329                   types of connection error.
1330                 * purple_connection_error_reason(), to be used by prpls
1331                   (instead of purple_connection_error() and setting
1332                   gc->wants_to_die) to report errors along with a
1333                   PurpleDisconnectReason.
1334                 * PurpleConnectionUiOps.report_disconnect_reason, to be
1335                   implemented by UIs (rather than .report_disconnect) if
1336                   they want to use the reported PurpleDisconnectReason
1337                   to give a more specific error.
1338                 * A connection-error signal, fired just after the UiOp is
1339                   called with the same information.
1340                 * purple_connection_reason_is_fatal(), acting as a hint
1341                   to whether automatic reconnection should be attempted
1342                   after a connection error (rather than checking
1343                   gc->wants_to_die).
1344                 * PurpleConnectionErrorInfo, a struct to hold a
1345                   PurpleConnectionError and a const char *description.
1346                 * purple_account_get_current_error() to get the most recent
1347                   PurpleConnectionError and description (or NULL if the
1348                   account is happy with life), to allow bits of the UI to know
1349                   the last error without caching it themselves (as
1350                   PidginBuddyList does).
1351                 * purple_account_clear_current_error() to reset an account's
1352                   error state to NULL.
1353                 * An account-error-changed signal, firing when
1354                   purple_account_get_current_error()'s return value changes.
1355
1356                 * PidginMiniDialog, a Gtk widget-ified version of
1357                   pidgin_make_mini_dialog().
1358
1359                 * purple_util_init()
1360                 * purple_util_uninit()
1361
1362                 * purple_network_listen_map_external() to temporarily disable
1363                   mapping ports externally via NAT-PMP or UPnP.
1364
1365                 Changed:
1366                 * purple_plugin_unload() now honors the return value of a
1367                   plugin's unload function and can actually return FALSE now.
1368                 * purple_plugin_unload() no longer does its own notifications
1369                   when a dependent plugin fails to unload.  The UI should do
1370                   something appropriate.
1371
1372                 * pidgin_make_mini_dialog() now declares its return type to be
1373                   GtkWidget * rather than void *.  This should not break any
1374                   existing code since any code using it must already rely on
1375                   the return type actually being GtkWidget * all along.
1376
1377                 Deprecated:
1378                 * pidgin_dialogs_about()
1379                 * pidgin_log_show_contact()
1380                 * pidgin_log_show()
1381                 * pidgin_plugin_dialog_show()
1382                 * pidgin_pounce_editor_show()
1383                 * pidgin_pounces_manager_show()
1384                 * pidgin_syslog_show()
1385
1386                 * purple_connection_error()
1387                 * pidgin_blist_update_account_error_state()
1388                 * PidginBuddyList.connection_errors
1389                 * purple_network_listen_map_external()
1390
1391                 MSN:
1392                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
1393                   PURPLE_TUNE_ARTIST, PURPLE_TUNE_ALBUM and PURPLE_TUNE_TITLE
1394                   attributes.
1395
1396                 XMPP:
1397                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
1398                   PURPLE_TUNE_{ARTIST, TITLE, ALBUM, GENRE, COMMENT, TRACK, TIME,
1399                   YEAR, URL} attributes.
1400
1401         Finch:
1402                 libgnt:
1403                 * Added gnt_color_pair, which will try to intelligenty set text
1404                   attributes in place of colors if the terminal doesn't have color
1405                   support. (Bug: #3560) All future code should use gnt_color_pair
1406                   instead of COLOR_PAIR.
1407                 * Added gnt_menuitem_set_id and gnt_menuitem_get_id to set and get the
1408                   string id of a menuitem respectively.
1409                 * Added gnt_window_get_accel_item, which returns a the id of a menuitem
1410                   bound to a keystroke.
1411                 * Added gnt_menu_get_item to get a menuitem of the given id from a
1412                   menu.
1413                 * Added gnt_menuitem_activate, which triggers the 'activate' signal on
1414                   the menuitem and calls the callback function, if available.
1415                 * Added GntEntryKillRing in GntEntry.
1416                 * Added gnt_window_set_maximize and gnt_window_get_maximize, and
1417                   GntWindowFlags enum.
1418
1419 version 2.2.2 (10/23/2007):
1420         libpurple:
1421                 Changed:
1422                 * The size parameter of purple_util_write_data_to_file_absolute
1423                   has been changed to gssize instead of a size_t to correctly
1424                   indicate that -1 can be used for a nul-delimited string.
1425                 * The documentation for purple_savedstatuses_get_popular used to
1426                   incorrectly claim that the active status is excluded from the
1427                   returned list. The documentation has been corrected. Also, the
1428                   function now returns a correct list when called with a value of 0.
1429
1430 version 2.2.0 (09/13/2007):
1431         libpurple:
1432                 Added:
1433                 * PURPLE_MESSAGE_INVISIBLE flag, which can be used by
1434                   purple_conv_im_send_with_flags to send a message, but not display it
1435                   in the conversation
1436                 * serv_send_attention(), serv_got_attention(), as well as send_attention
1437                   and attention_types in PurplePluginProtocolInfo. This new API is used
1438                   for zapping in MySpaceIM, buzzing in Yahoo, and nudging in MSN.
1439                 * PurpleConvMessage structure to represent a message in a
1440                   conversation. purple_conversation_message_get_sender,
1441                   purple_conversation_message_get_message,
1442                   purple_conversation_message_get_flags and
1443                   purple_conversation_message_get_timestamp to get information about a
1444                   PurpleConvMessage.
1445                 * purple_conversation_get_message_history() to retrieve a list of
1446                   PurpleConvMessage's in a conversation, and
1447                   purple_conversation_clear_message_history to clear the history.
1448                 * purple_certificate_* functions in libpurple/certificate.h - "A public-key certificate API"
1449                 * purple_ssl_get_peer_certificates() and associated field in PurpleSslOps to retrieve a server's presented SSL certificate chain.
1450                 * PurpleSslConnection::verifier to provide a "how to verify the peer's certificates" callback to the SSL handlers. See certificate.h for more on this.
1451                 * purple_ssl_connect_with_host_fd() to create an SSL connection from a file descriptor and provide a hostname with it to authenticate the peer against.
1452
1453                 Changed:
1454                 * purple_prefs_load is now called within purple_prefs_init.
1455                   The UI no longer needs to call it.
1456                 * writing-im-msg now receives the conversation name as the who
1457                   argument if the caller of purple_conversation_write didn't
1458                   provide a value for who.
1459
1460         Pidgin:
1461                 Added:
1462                 * pidgin_set_accessible_relations, sets up label-for and labelled-by
1463                   ATK relations (broken out from pidgin_set_accessible_label)
1464                 * pidgin_conv_attach_to_conversation, to reattach the Pidgin UI to a
1465                   conversation
1466                 * conversation-hiding and conversation-displayed signals.
1467                 * pidgin_text_combo_box_entry_new, pidgin_text_combo_box_entry_get_text
1468                   and pidgin_text_combo_box_entry_set_text
1469
1470                 Changed:
1471                 * pidgin_conversations_fill_menu now also adds a separator and a 'Show
1472                   All' item if there are more than one conversations in the list.
1473
1474         Finch:
1475                 Added:
1476                 * finch_sound_is_enabled
1477                 * The reserved field in the FinchConv is now used to store information
1478                   about the conversation (using FinchConversationFlag)
1479                 * finch_account_dialog_show
1480
1481                 libgnt:
1482                 * gnt_slider_set_small_step, gnt_slider_set_large_step to allow more
1483                   fine tuned updates of a GntSlider
1484                 * gnt_util_parse_xhtml_to_textview to parse XHTML strings in a
1485                   GntTextView (this works only if libxml2 is available)
1486
1487 version 2.1.1 (08/20/2007):
1488         libpurple:
1489                 Changed:
1490                 * PurpleAccountUiOps.request_authorize's authorize_cb and
1491                   deny_cb parameters now correctly have type
1492                   PurpleAccountRequestAuthorizationCb rather than GCallback.
1493                   (You'll want to change your UI's implementation's signature
1494                   to avoid warnings, and then remove some now-redundant casts
1495                   back to the proper type.)
1496
1497 version 2.1.0 (7/28/2007):
1498         libpurple:
1499                 Added:
1500                 * purple-remote: added getstatus command
1501                 * conversation-extended-menu signal (See Doxygen docs)
1502                 * OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
1503                   slash commands are "native" to the protocol
1504                 * PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
1505                   should not be auto-linkified
1506                 * PurpleEventLoopUiOps.timeout_add_seconds
1507                     UIs can now use better scheduling for whole-second timers.  For
1508                     example, clients based on the glib event loop can now use
1509                     g_timeout_add_seconds.
1510                 * purple_blist_node_get_type
1511                 * purple_conversation_do_command
1512                 * purple_conversation_get_extended_menu
1513                 * purple_core_ensure_single_instance
1514                     This is for UIs to use to ensure only one copy is running.
1515                 * purple_dbus_is_owner
1516                 * purple_timeout_add_seconds
1517                     Callers should prefer this to purple_timeout_add for timers
1518                     longer than 1 second away.  Be aware of the rounding, though.
1519                 * purple_xfer_get_remote_user
1520                 * purple_pounces_get_all_for_ui
1521                 * purple_prefs_get_children_names
1522                 * added displaying-email-notification and
1523                   displaying-emails-notification signals
1524
1525                 Changed:
1526                 * The documentation of the following functions now properly
1527                   declares that the returned value must not be modified or
1528                   freed, which was always the case:
1529                         * purple_accounts_get_all
1530                         * purple_connections_get_all
1531                         * purple_connections_get_connecting
1532                         * purple_conv_chat_get_ignored
1533                         * purple_conv_chat_get_users
1534                         * purple_get_chats
1535                         * purple_get_conversations
1536                         * purple_get_ims
1537                         * purple_notify_user_info_get_entries
1538                 * The following functions now return a GList* instead of a
1539                   const GList*, as const is not very useful with GLists.  The
1540                   returned value still must not be modified or freed:
1541                         * purple_account_get_status_types
1542                         * purple_mime_document_get_fields
1543                         * purple_mime_document_get_parts
1544                         * purple_mime_part_get_fields
1545                         * purple_request_fields_get_required
1546                         * purple_request_field_list_get_selected
1547                         * purple_request_field_list_get_items
1548                         * purple_status_type_get_attrs
1549                         * purple_presence_get_statuses
1550                 * purple_request_field_list_set_selected now takes a GList*
1551                   instead of a const GList* for items, as const is not very
1552                   useful with GLists.  The passed list is still not modified
1553                   or freed.
1554                 * purple_presence_add_list now takes a GList* instead of a
1555                   const GList* for source_list, as const is not very useful with
1556                   GLists.  The passed list is still not modified or freed.
1557
1558         Pidgin:
1559                 Added:
1560                 * gtk_imhtml_setup_entry
1561                 * pidgin_create_window
1562                 * pidgin_retrieve_user_info and pidgin_retrieve_user_info_in_chat,
1563                   shows immediate feedback when getting information about a user.
1564                 * gtk_imhtml_animation_new
1565                     Can be used for inserting an animated image into an IMHTML.
1566                 * pidgin_menu_position_func_helper
1567                 * pidgin_blist_get_name_markup, returns the buddy list markup
1568                   text for a given buddy.
1569                 * pidgin_blist_draw_tooltip and pidgin_blist_tooltip_destroy
1570                   for creating blist tooltips from outside of buddy list code
1571                 * pidgin_themes_remove_smiley_theme
1572
1573                 Changed:
1574                 * pidgin_append_menu_action returns the menuitem added to the menu.
1575                 * pidgin_separator returns the separator added to the menu.
1576                 * PidginConversation has struct members to handle the new info
1577                   pane:
1578                         * infopane
1579                         * infopane_hbox
1580                         * infopane_model
1581                         * infopane_iter
1582
1583         Finch:
1584                 Added:
1585                 * finch_retrieve_user_info
1586
1587                 libgnt:
1588                         Added:
1589                         * GntWS for workspaces
1590                         * gnt_tree_set_column_title
1591                         * GntSlider widget
1592                         * "completion" signal for GntEntry
1593                         * "terminal-refresh" signal for GntWM, with a corresponding entry
1594                           in GntWMClass
1595                         * New flags for GntTextView to decide whether to word-wrap or show
1596                           scrollbars (GntTextViewFlag) which can be set by
1597                           gnt_text_view_set_flag
1598                         * gnt_style_get_from_name
1599                         * gnt_window_present
1600                         * gnt_tree_set_column_width_ratio
1601                         * gnt_tree_set_column_resizable
1602                         * gnt_tree_set_column_is_right_aligned
1603                         * gnt_tree_set_search_function, gnt_tree_set_search_column,
1604                           gnt_tree_is_searching
1605                         * 'file-selected' signal is emited for GntFileSel
1606                         * gnt_style_parse_bool
1607                         * gnt_util_set_trigger_widget
1608
1609                         Changed:
1610                         * gnt_tree_get_rows() now returns a GList* instead of a const
1611                           GList*, as const is not very useful with GLists.  The
1612                           returned value still must not be modified or freed.
1613                         * Instead of keeping an 'invisible' item, the GntTreeColumns now
1614                           maintain 'flags' with the appropriate flags set
1615
1616 version 2.0.2 (6/14/2007):
1617         Pidgin:
1618                 Deprecated:
1619                 * pidgin_dialogs_alias_contact:  This will be removed in 3.0.0
1620                   unless there is sufficient demand to keep it.
1621
1622 version 2.0.0 (5/3/2007):
1623         Please note all functions, defines, and data structures have been
1624         re-namespaced to match the new names of Pidgin, Finch, and libpurple.
1625         All gaim_gtk_* functions are now pidgin_*, former libgaim functions are
1626         now purple_*.  Please consult our doxygen documentation for a complete
1627         reference.
1628
1629         The gaim-compat.h header exists to provide an API compatibility layer
1630         for libpurple functions.  As an API compatibility layer, it must be
1631         included at compile time to be of use.
1632
1633         Changed:
1634         * All the status stuff.  Yay!
1635         * gaim_prefs_connect_callback(), added handle parameter
1636         * gtk_imhtml_toolbar now descends from GtkHBox making it easier to add your
1637           own widgets to it
1638         * gaim_find_conversation_with_account, added a "type" parameter
1639         * gaim_gtk_prefs_labeled_spin_button, the "key" parameter is now a
1640           const char* instead of just a char*
1641         * gaim_gtk_prefs_labeled_entry, the "key" parameter is now a const char*
1642           instead of just a char*
1643         * the add_buddy perl sub.  The sub now takes the account as the first
1644           argument, and buddy and group as the second and third.  It also adds
1645           the buddy to the server-side buddy list of the given account.
1646         * gaim_connection_new, gaim_account_connect and gaim_account_register no
1647           longer return a GaimConnection
1648         * keep_alive in GaimConnection is renamed to keepalive
1649         * gaim_mkstemp, added a second argument, a boolean, of whether or not the
1650           file is binary
1651         * gaim_log_logger_new, rewritten
1652         * gaim_conv_window_remove_conversation()'s last argument to be a
1653           GaimConversation.
1654         * A new blocked icon: pixmaps/status/default/blocked.png
1655         * In pixmaps/status/default: extendedaway.png renamed to extended_away.png
1656         * In pixmaps/status/default: na.png renamed to unavailable.png
1657         * gtk_imhtml_toggle_bold(): No longer returns a value
1658         * gtk_imhtml_toggle_italic(): No longer returns a value
1659         * gtk_imhtml_toggle_underline(): No longer returns a value
1660         * gtk_imhtml_toggle_strike(): No longer returns a value
1661         * gtk_imhtml_scroll_to_end(): Added the smooth paramter
1662         * gaim_log_new(), added conv parameter
1663         * gaim_buddy_icon_new(), leaves a reference which the caller owns.  Use
1664           gaim_buddy_icon_unref() immediately if you don't want a reference (the
1665           old behavior).
1666         * GAIM_CONV_UNKNOWN to GAIM_CONV_TYPE_UNKNOWN.
1667         * GAIM_CONV_IM to GAIM_CONV_TYPE_IM.
1668         * GAIM_CONV_CHAT to GAIM_CONV_TYPE_CHAT.
1669         * GAIM_CONV_MISC to GAIM_CONV_TYPE_MISC.
1670         * GAIM_CONV_ANY to GAIM_CONV_TYPE_ANY.
1671         * GaimConversationUiOps.write_conv, Replaced const char *who with
1672           const char *name, const char *alias
1673         * gaim_conv_chat_add_users(), added extra_msgs and new_arrivals (pass NULL
1674           and FALSE respectively, to get the same behavior as before)
1675         * chat_add_users in GaimConversationUiOps, added cbuddies and
1676           new_arrivals and removed buddies.
1677         * chat_rename_user in GaimConversationUiOps, added new_alias
1678         * gaim_conv_chat_cb_new(), added alias. (pass NULL to get the same
1679           behavior as before).
1680         * GaimConversation.log became GList * GaimConversation.logs, so that a
1681           conversation can have multiple logs at once
1682         * gaim_conv_chat_add_user, added extra_msgs
1683         * gaim_notify_userinfo, removed primary and secondary parameters
1684         * GaimNotifyUiOps.notify_userinfo: removed title, primary, and
1685           secondary parameters
1686         * Idle timers are now added and removed in gtkidle.c in response
1687           to the signed-on and signed-off signals
1688         * GaimXfer->ops.read, GaimXfer->ops.write, gaim_xfer_set_read_fnc(),
1689           gaim_xfer_set_write_fnc(), gaim_xfer_read(), gaim_xfer_write():
1690           Changed ssize_t to gssize
1691         * serv_got_im, serv_got_chat_in, serv_send_im and serv_chat_send all use
1692           GaimMessageFlags instead of GaimConvImFlags / GaimConvChatFlags
1693         * All core<->prpl message passing now uses html.  This was previously true
1694           for receiving messages, it's now also true for sending them.  prpls that
1695           don't support html need to gaim_unescape_html() the message.
1696         * Notify API: GCallback -> GaimNotifyCloseCallback,
1697                       void *user_data -> gpointer user_data
1698         * gaim_notify_searchresults_get_rows_count,
1699           gaim_notify_searchresults_get_columns_count: return type now guint
1700         * gaim_account_notify_added: No longer checks if there is a
1701           GaimBuddy for the added user, that's left up to the prpls.  See the
1702           documentation for this function and gaim_account_request_add.
1703         * gaim_accounts_reorder: new_index is now a gint instead of a size_t
1704         * displaying-message signals: displaying-[im|chat]-msg and
1705           displayed-[im|chat]-msg signals are emitted for all messages
1706           (ie, for received messages, sent messages, system messages, error
1707           messages etc.), and the signals now have
1708           gaim_gtk_conversations_get_handle() for their handle.
1709         * GAIM_NOTIFY_BUTTON_ADD_BUDDY to GAIM_NOTIFY_BUTTON_ADD
1710         * conversation-switched: This signal has been moved from conversation to
1711                                  the UI and the signal-handlers only receive the
1712                                  conversation that has been switched to.
1713         * GaimPluginProtocolInfo: Added offline_message
1714         * GaimPluginProtocolInfo: Added whiteboard_prpl_ops
1715         * GaimPluginProtocolInfo: Added media_prpl_ops
1716         * GaimPluginProtocolInfo: Added "user_info" argument to tooltip_text,
1717                                   changed the return type to void
1718         * GaimPluginProtocolInfo: Added "full" argument to tooltip_text
1719         * gaim_pounce_new(): Added option argument for pounce options
1720         * gaim_network_listen() and gaim_network_listen_range(): Added
1721           socket_type parameter to allow creation of UDP listening. Modified
1722           to be asynchronous with a callback to allow for UPnP operation.
1723           Returns a data structure that can be used to cancel the listen
1724           attempt using gaim_network_listen_cancel()
1725         * GaimPrefCallback: val is now a gconstpointer instead of a gpointer
1726         * gtk_imhtml_get_current_format(): the arguments are now set to TRUE or
1727           FALSE.  Previously they were set to TRUE or left alone.  Also, you
1728           may now pass NULL if you're not interested in a specific formatting.
1729         * Smiley Themes: Backslashes must be backslash-escaped.
1730         * Plugins: Depedencies are now honored when unloading plugins.
1731         * gaim_markup_extract_info_field(): Added format_cb parameter.
1732         * gaim_markup_extract_info_field(): Changed GString parameter to a GaimNotifyUserInfo paramter.
1733         * gaim_str_to_time(): Added support for parsing the MM/DD/YYYY format.
1734         * gaim_plugin_action_new(): label is now const char *
1735         * gaim_plugin_pref_new_with_name(): name is now const char *
1736         * gaim_plugin_pref_new_with_label(): label is now const char *
1737         * gaim_plugin_pref_new_with_name_and_label(): name and label are
1738           now const char *
1739         * gaim_plugin_pref_set_name(): name is now const char *
1740         * gaim_plugin_pref_get_name(): return type is now const char *
1741         * gaim_plugin_pref_set_label(): label is now const char *
1742         * gaim_plugin_pref_get_label(): return type is now const char *
1743         * gaim_plugin_pref_add_choice(): label is now const char *
1744         * struct proto_chat_entry: label is now const char *
1745         * struct proto_chat_entry: identifier is now const char *
1746         * All network activity has been updated to use non-blocking sockets.
1747           This means that plugins must be updated to expect such a socket from
1748           gaim_proxy_connect() and gaim_network_listen*().
1749         * gaim_proxy_connect(): changed to return NULL on error and a pointer
1750           to a GaimProxyConnectInfo object which can be used to cancel
1751           connection attempts using gaim_proxy_connect_cancel().  Also added
1752           a 'handle' parameter that can be used to cancel the connection
1753           attempt using gaim_proxy_connect_cancel_with_handle().
1754         * gaim_gethostbyname_async(): Renamed to gaim_dnsquery_a() and
1755           changed to return a pointer to a data structure that can be
1756           used to cancel the pending DNS query using gaim_dnsquery_destroy()
1757         * gaim_url_fetch(): Renamed to gaim_util_fetch_url() and changed
1758           to return a pointer to a data structure that can be used to cancel
1759           the pending HTTP request using gaim_util_fetch_url_cancel().
1760           Corresponding callback has changed to accept this data structure
1761           as its first argument, and to accept an error message as an
1762           additional final argument.
1763         * gaim_gtk_create_imhtml(): Added sw_ret() parameter
1764         * gaim_account_get_log(): Added create parameter
1765         * GAIM_CMD_P_VERYHIGH is now GAIM_CMD_P_VERY_HIGH
1766         * gtk_imhtml_search_find(): Now wraps around to the top instead of
1767           clearing the search at the end.
1768         * gaim_gtkxfer_dialog_show: Can now take NULL to show (and possibly
1769           create) a default gtkxfer dialog.
1770         * CHAT_USERS_BUDDY_COLUMN became CHAT_USERS_WEIGHT_COLUMN, along with
1771           a change in the values stored in the column.
1772         * gaim_find_buddies() returns a list of all buddies in the account if name
1773           is NULL.
1774         * gaim_gtk_set_custom_buddy_icon() sets custom icon for a user.
1775         * Hid the definition of _GaimStringref, which already had a warning to
1776           avoid accessing it directly.
1777         * notify_userinfo() UI op is passed a GaimNotifyUserInfo instead of a char*
1778           for the user information
1779         * gaim_buddy_icon_get_scale_size() and was changed to ALWAYS scale
1780           the icon instead of only when icon_spec->scale_rules contains
1781           GAIM_ICON_SCALE_DISPLAY.  Callers should be changed to check the
1782           scale_rules before calling this function.
1783         * gaim_gtk_buddy_icon_get_scale_size() was changed to accept an
1784           additional parameter which is used to determine what kind of
1785           scaling should be done, if any.
1786         * purple_request_input(), purple_request_choice(),
1787           purple_request_choice_varg(), purple_request_action(),
1788           purple_request_action_varg(), purple_request_fields(),
1789           purple_request_yes_no(), purple_request_ok_cancel(),
1790           purple_request_accept_cancel(), purple_request_file(), and
1791           purple_request_folder() was changed to accept account, who, and
1792           conversation parameters for associating the request with an account, a
1793           buddy, or a conversation.
1794         * Significant changes to the buddy icon and imgstore APIs.  If you
1795           were using any of it, it's best to look at the header files or
1796           Doxygen documentation, but here are some significant changes:
1797             purple_buddy_icon_new() now takes ownership of ("frees") icon_data
1798             purple_buddy_icon_set_data(): likewise for data
1799             purple_buddy_icon_set_for_user(): likewise for data
1800             purple_buddy_icon_set_for_user() now takes a checksum parameter
1801             purple_imgstore_add() was renamed to purple_imgstore_add_with_id()
1802               which takes ownership of data
1803
1804         Removed:
1805         * gaim_gtk_sound_{get,set}_mute() (replaced by the /gaim/gtk/sound/mute
1806           preference)
1807         * gaim_escape_html(const char *html) (use g_markup_escape_text(html, -1)
1808           instead)
1809         * gaim_accounts_sync, account changes are now scheduled to be saved
1810           automatically
1811         * gaim_connection_connect
1812         * gaim_connection_disconnect
1813         * gaim_connection_register
1814         * gaim_accounts_auto_login
1815         * gaim_find_conversation, use gaim_find_conversation_with_account instead
1816         * gaim_chat_get_display_name
1817         * gaim_conversation_set_history, gaim_conversation_get_history, and
1818           GaimConversation->history.  Use gtk_imhtml_get_markup instead.
1819         * set_gaim_user_dir to gaim_util_set_user_dir
1820         * create_prpl_icon to gaim_gtk_create_prpl_icon
1821         * Window flashing support in the core: gaim_conv_window_flash, and flash UI
1822           operation for conversations.  Use signal "received-im-msg" or similar.
1823         * All warning stuff from the core.
1824         * gaim_gtkconv_get_dest_tab_at_xy(), instead use gaim_gtkconv_get_tab_at_xy()
1825         * chat_add_user from GaimConversationUiOps: only chat_add_users is used
1826         * chat_remove_user from GaimConversationUiOps: only chat_remove_users is used
1827         * uc from the GaimBuddy struct
1828         * gaim_sound_get_handle()
1829         * gaim_debug_vargs()
1830         * serv_add_buddy(); use gaim_account_add_buddy() instead
1831         * serv_add_buddies(); use gaim_account_add_buddies() instead
1832         * serv_change_passwd(); use gaim_account_change_password() instead
1833         * serv_close()
1834         * serv_finish_login()
1835         * serv_login()
1836         * serv_remove_buddy(); use gaim_account_remove_buddy() instead
1837         * serv_remove_buddies(); use gaim_account_remove_buddies() instead
1838         * serv_rename_group()
1839         * serv_set_buddyicon(): use gaim_account_set_buddy_icon() instead
1840         * serv_touch_idle(): use gaim_gtk_check_idle() instead
1841         * GaimGtkImPane->a_virgin
1842         * gaim_str_strip_cr(); use gaim_str_strip_char(str, '\r') instead
1843         * gaim_find_buddys_group renamed to gaim_buddy_get_group
1844         * gaim_gtkpounce_menu_build()
1845         * gaim_gtkpounce_dialog_show()
1846         * GaimGtkBuddyList->bpmenu
1847         * GaimConvImFlags and GaimConvChatFlags; use GaimMessageFlags instead
1848         * cb and user_data from the ops in GaimNotifyUiOps: This is now handled
1849           by the notify API in the core.
1850         * GaimConversationUiOps.updated: use the conversation-updated signal
1851         * GAIM_SUBTYPE_CONV_WINDOW: windows are now only represented in the UI,
1852           so GAIM_TYPE_BOXED is used for the signal types
1853         * gaim_gtk_privacy_is_showable(): We do fallback privacy in the core
1854           now, so this would always be TRUE now.
1855         * GaimBlistNodeAction: See GaimMenuAction
1856         * gaim_blist_node_action_new(); use gaim_menu_action_new() instead
1857         * gaim_date()
1858         * gaim_date_full(): See gaim_date_format_full()
1859         * gaim_strftime(): See gaim_utf8_strftime()
1860         * GAIM_MESSAGE_COLORIZE
1861         * user_data from gaim_notify_searchresults_new_rows and from
1862           notify_searchresults in GaimNotifyUiOps.
1863         * gaim_conversation_get_send_history(), and send_history from
1864           GaimConversation
1865         * Removed ui_ops from GaimBuddyList. Use gaim_blist_get_ui_ops() instead
1866         * GaimGtkConversation: dialogs (dialogs.search moved to GaimGtkWindow)
1867         * gaim_show_xfer_dialog: Use gaim_gtk_xfer_dialog_show(NULL) instead.
1868         * GaimGtkRoomlistDialog: Nothing used it outside of the file it was in.
1869         * gaim_gtk_roomlist_dialog_new: use gaim_gtk_roomlist_show
1870         * gaim_gtk_roomlist_dialog_new_with_account: use gaim_gtk_roomlist_show_with_account
1871         * binreloc functions
1872
1873         Added:
1874         * gaim_prefs_disconnect_by_handle()
1875         * a password field to GaimConnection, which only persists for the
1876           session (when "remember password" is false, account->password is
1877           NEVER set) Use gaim_connection_get_password(GaimConnection *gc)
1878         * gaim_log_common_writer, gaim_log_common_lister, gaim_log_common_sizer,
1879           and gaim_log_get_log_dir to allow log formats that use standard Gaim
1880           log directory to use Gaim's built-in code for these purposes.
1881         * GaimLogCommonLoggerData struct for a basic logger_data struct to be
1882           used with "common" logger functions.
1883         * gaim_gtk_blist_node_is_contact_expanded, returns TRUE if the given
1884           blist node is a buddy inside an expanded contact, or is itself an
1885           expanded contact
1886         * GaimLogSet struct, get_log_sets function to GaimLogLogger,
1887           gaim_log_get_log_sets, gaim_log_set_compare
1888         * gaim_privacy_check(), to check if a given user is allowed to send
1889           messages to the specified account
1890         * gtk_imhtml_clear_formatting()
1891         * gtk_imhtml_delete to clear out part of a imhtml buffer
1892         * gtk_imhtml_get_protocol_name()
1893         * gaim_buddy_icons_get_full_path(), to get the full path of a buddy
1894           icon setting
1895         * CHAT_USERS_ALIAS_COLUMN, CHAT_USERS_COLOR_COLUMN,
1896           CHAT_USERS_BUDDY_COLUMN to the list of columns for the chat
1897           user list
1898         * gaim_account_add_buddy()
1899         * gaim_account_add_buddies()
1900         * gaim_account_remove_buddy()
1901         * gaim_account_remove_buddies()
1902         * gaim_account_change_password()
1903         * gaim_account_supports_offline_message()
1904         * gaim_conversation_close_logs(), to force a conversation's log(s) to
1905           be closed.  New logs will be opened as necessary.
1906         * gaim_got_protocol_handler_uri()
1907         * gaim_plugin_get_id()
1908         * gaim_plugin_get_name()
1909         * gaim_plugin_get_version()
1910         * gaim_plugin_get_summary()
1911         * gaim_plugin_get_description()
1912         * gaim_plugin_get_author()
1913         * gaim_plugin_get_homepage()
1914         * gaim_gtkconv_switch_active_conversation(GaimConversation *)
1915         * gaim_str_strip_char() to strip a given character from
1916           a given string
1917         * gaim_util_chrreplace() to replace a given character with a
1918           different character
1919         * gaim_gtk_blist_toggle_visibility() to intelligently toggle the
1920           visiblity of the buddy list
1921         * gaim_gtk_blist_visibility_manager_add() to indicate the addition of a
1922           visibility manager - see the docs for more information
1923         * gaim_gtk_blist_visibility_manager_remove() to indicate the removal of
1924           a visibility manager - see the docs for more information
1925         * gaim_gtk_conversations_find_unseen_list() to get a list of conversations
1926           with an "unseen" state >= to the specified state and other criteria
1927         * gaim_gtk_conversations_fill_menu() fill a menu from list of conversations
1928         * gaim_gtk_create_prpl_icon()
1929         * gaim_gtk_create_prpl_icon_with_status()
1930         * gaim_gtk_pounces_manager_show()
1931         * gaim_gtk_pounces_manager_hide()
1932         * gaim_gtk_pounce_editor_show()
1933         * GAIM_POUNCE_MESSAGE_RECEIVED
1934         * GaimPounceOption
1935         * gaim_pounce_set_options()
1936         * gaim_pounce_set_options()
1937         * GAIM_STOCK_CONNECT, GAIM_STOCK_DISCONNECT
1938         * GAIM_STOCK_PLUGIN
1939         * gaim_account_request_add: Notifies the user that they were added to
1940                                     someone's buddy list, and offers them the choice
1941                                     of adding that person to their buddy list.
1942         * gaim_blist_alias_contact()
1943         * gaim_cipher_http_digest_calculate_session_key()
1944         * gaim_cipher_http_digest_calculate_response()
1945         * gaim_notify_searchresults_labeled()
1946         * GAIM_NOTIFY_BUTTON_LABELED, GAIM_NOTIFY_BUTTON_INFO,
1947           GAIM_NOTIFY_BUTTON_IM, GAIM_NOTIFY_BUTTON_JOIN,
1948           GAIM_NOTIFY_BUTTON_INVITE
1949         * stock buttons GAIM_STOCK_IM, GAIM_STOCK_INFO
1950         * gaim_conversation_present()
1951         * GaimConversationUiOps->present(GaimConversation *)
1952         * GaimPlugin.unloadable
1953         * gaim_plugin_is_unloadable()
1954         * GAIM_PLUGIN_PREF_STRING_FORMAT
1955         * gaim_plugin_pref_get_format_type()
1956         * gaim_plugin_pref_set_format_type()
1957         * GaimStringFormatType
1958         * gaim_log_get_handle()
1959         * gaim_log_uninit()
1960         * GAIM_SUBTYPE_LOG
1961         * gaim_marshal_POINTER__POINTER_POINTER
1962         * gaim_utf8_ncr_encode()
1963         * gaim_gtk_log_init()
1964         * gaim_gtk_log_get_handle()
1965         * gaim_gtk_log_uninit()
1966         * gaim_util_fetch_url_request()
1967         * GaimMenuAction
1968         * gaim_menu_action_new()
1969         * gaim_menu_action_free()
1970         * GaimInfoFieldFormatCallback
1971         * gaim_utf8_strftime()
1972         * gaim_date_format_short()
1973         * gaim_date_format_long()
1974         * gaim_date_format_full()
1975         * gaim_time_format()
1976         * gaim_plugin_action_free()
1977         * GaimRequestType: Added GAIM_REQUEST_FOLDER
1978         * GaimRequestUiOps: Added request_folder
1979         * gaim_request_folder()
1980         * gaim_gtk_setup_screenname_autocomplete()
1981         * gaim_gtk_set_cursor()
1982         * gaim_gtk_clear_cursor()
1983         * GAIM_MESSAGE_ACTIVE_ONLY
1984         * gaim_proxy_get_setup()
1985         * GaimNotifySearchResultsCallback: Added user_data.
1986         * gaim_notify_searchresults: Added user_data.
1987         * gaim_network_listen_cancel(): Can be used to cancel a previous
1988           call to gaim_network_listen() or gaim_network_listen_range()
1989         * gaim_proxy_connect_cancel(): Can be used to cancel a pending
1990           gaim_proxy_connect() request
1991         * gaim_proxy_connect_cancel_with_handle(): Can be used to cancel
1992           a previous gaim_proxy_connect() request using a specified handle
1993         * gaim_dnsquery_destroy(): Can be used to cancel a pending DNS
1994           query.
1995         * gaim_util_fetch_url_cancel(): Can be used to cancel a pending
1996           call to gaim_util_fetch_url() or gaim_util_fetch_url_request().
1997         * GaimGtkWindow: dialogs.search (previously in GaimGtkConversation)
1998         * gaim_buddy_get_server_alias()
1999         * gaim_conv_send_confirm()
2000         * GaimConversationUiOps.send_confirm
2001         * gaim_gtk_roomlist_dialog_show_with_account
2002         * gaim_gtk_tree_view_search_equal_func to be used with
2003           gtk_tree_view_set_search_equal_func
2004         * gaim_xfer_set_bytes_sent().  Sets the offset in the file to
2005           read from or write to.
2006         * gaim_privacy_deny and gaim_privacy_allow
2007         * gaim_gtk_blist_set_headline
2008         * gaim_gtk_set_urgent
2009         * GtkGaimScrollBook and its functions.
2010         * purple_markup_unescape_entity()
2011         * purple_markup_get_css_property()
2012         * purple_group_get_name()
2013
2014         Signals - Changed:  (See the Doxygen docs for details on all signals.)
2015         * Signal propagation now stops after a handler returns a non-NULL value.
2016           This value is now returned.  Previously, all registered handlers were
2017           called and the value from the last handler was used.
2018         * "buddy-typing" and "buddy-typing-stopped": replaced the GaimConversation*
2019           with GaimAccount*, const char *name.  Also, the signal is now emitted
2020           regardless of whether a conversation exists and regardless of whether
2021           the user is on the buddy list.
2022         * "chat-buddy-joined": added the new_arrival argument
2023         * "chat-invited" handlers can now return a value to control what happens
2024           to the invite (accept, reject, prompt the user).
2025         * "chat-left": Emitted *after* setting chat->left to TRUE.
2026         * "drawing-tooltip": the second argument is now a GString* instead of
2027           a char**
2028         * "drawing-tooltip": added the "full" argument
2029         * "received-im-msg" and "received-chat-msg" to match, both now pass a
2030           conversation pointer and flags
2031         * "receiving-im-msg" and "receving-chat-msg" to match, both now pass a
2032           conversation pointer and a pointer to the flags.
2033         * "writing-im-msg", "wrote-im-msg", "writing-chat-msg", "wrote-chat-msg":
2034           Now emitted from a difference place in the message handling code.
2035           The arguments also changed.
2036         * "displaying-im-msg", "displayed-im-msg", "displaying-chat-msg",
2037           "displayed-chat-msg": Added "who" argument, which changes the order
2038           of the existing arguments.
2039
2040         Signals - Added:  (See the Doxygen docs for details on all signals.)
2041         * "account-disabled"
2042         * "account-status-changed"
2043         * "account-alias-changed"
2044         * "cipher-added"
2045         * "cipher-removed"
2046         * "conversation-dragging"
2047         * "dbus-method-called"
2048         * "dbus-introspect"
2049         * "file-recv-accept"
2050         * "file-recv-start"
2051         * "file-recv-cancel"
2052         * "file-recv-complete"
2053         * "file-recv-request"
2054         * "file-send-accept"
2055         * "file-send-start"
2056         * "file-send-cancel"
2057         * "file-send-complete"
2058         * "buddy-added"
2059         * "buddy-removed"
2060         * "blist-node-aliased"
2061         * "buddy-status-changed"
2062         * "buddy-idle-changed": A buddy's idle status changed.
2063         * "buddy-icon-changed"
2064         * "buddy-got-login-time": The login time for a buddy is now known
2065         * "displaying-userinfo"
2066         * "gtkblist-hiding"
2067         * "gtkblist-unhiding"
2068         * "log-displaying"
2069         * "network-configuration-changed"
2070         * "savedstatus-changed"
2071         * "sendto-extended-menu"
2072         * "uri-handler"
2073
2074         Signals - Removed:
2075         * "account-away": replaced by account-status-changed
2076         * "account-warned"
2077         * "buddy-away": replaced by buddy-status-changed
2078         * "buddy-back": replaced by buddy-status-changed
2079         * "buddy-idle": replaced by buddy-idle-changed
2080         * "buddy-unidle": replaced by buddy-idle-changed
2081         * "buddy-icon-cached": replaced by buddy-icon-changed
2082         * "conversation-drag-end": replaced by conversation-dragging
2083         * "conversation-switching"
2084
2085 version 1.5.0 (8/11/2005):
2086         * Added: gaim_xfer_conversation_write
2087           Writes a messages to a conversation window with the use
2088           of the associated file transfer.
2089
2090 version 1.4.0 (7/7/2005):
2091         * Added: gaim_buddy_icon_uncache()
2092           Deletes a cached buddy icon for a specified buddy
2093         * Added: gaim_buddy_icon_get_type
2094           Attempts to determine the type of a given buddy icon.
2095         * Added: buddy-icon-cached signal
2096           Emitted when a new buddy icon is cached.
2097
2098 version 1.3.1 (6/9/2005):
2099         * No changes
2100
2101 version 1.3.0 (5/10/2005):
2102         * Added: gaim_blist_schedule_save()
2103           This should be used instead of gaim_blist_sync when you
2104           want the blist.xml file to be written to disk.  There
2105           should not be many occasions when you want to do this,
2106           as the functions in the blist API that modify the buddy
2107           list will normally call it for you.
2108         * Added: OPT_PROTO_NO_NORMALIZE_CONV
2109           Tells the conversation API to not normalize screen names
2110           in conversations.  This is used by the Jabber PRPL.
2111
2112 version 1.2.1 (4/3/2005):
2113         * No changes
2114
2115 version 1.2.0 (3/17/2005):
2116         * You can use gaim_signal_connect_priority() and
2117           gaim_signal_connect_priority_vargs() to connect to
2118           Gaim signals with a given priority (Will Gorman)
2119         * Added: gaim_conversation_set_features
2120                  gaim_conversation_get_features
2121           These allow plugins (notable prpls) to change the
2122           formatting capabilities of an existing conversation.
2123           This comes with a new "features" field in
2124           GaimConversation (Christopher O'Brien)
2125         * Added: GAIM_CONNECTION_NO_IMAGES to GaimConectionFlags
2126            (Christopher O'Brien)
2127         * Added: GAIM_CBFLAGS_TYPING to GaimConvChatBuddyFlags
2128            (Christopher O'Brien)
2129         * Added: gaim_account_request_add which takes the same arguments as
2130         *  gaim_account_notify_added but always asks the user if they want to add
2131         *  the buddy to the buddy list
2132         * Added: An accompanying request_add GaimAccountUiOp
2133
2134 version 1.1.4 (2/24/2005):
2135         * No changes
2136
2137 version 1.1.3 (2/17/2005):
2138         * No changes
2139
2140 version 1.1.2 (1/20/2005):
2141         * No changes
2142
2143 version 1.1.1 (12/28/2004):
2144         * No changes
2145
2146 version 1.1.0 (12/02/2004):
2147         * Added: gaim_utf8_salvage
2148         * Added: binary relocation support in prefix.h
2149                  WARNING: If your plugin uses anything inside the
2150                  #ifdef ENABLE_BINRELOC from prefix.h, it won't be
2151                  loadable on a copy of Gaim compiled without binreloc
2152                  support. In particular, watch out for the autoconf-like
2153                  macros, and accidently including them through internal.h,
2154                  which you probably shouldn't be including anyway.
2155
2156 version 1.0.0 (09/17/2004):
2157         * Added: get_chat_name to the GaimPluginProtocolInfo struct
2158         * Changed: gaim_blist_update_buddy_presence(), presence changed to
2159                    type gboolean
2160         * Changed: the versioning scheme, and all the plugin structs
2161
2162 version 0.82 (08/26/2004):
2163         Gaim API:
2164         * Removed: gaim_gtk_get_dispstyle(), gaim_gtk_change_text()
2165         * Removed: multi.h
2166         * Renamed: ui.h to gtkdialogs.h
2167         * Renamed: gtkinternal.h to gtkgaim.h
2168         * Renamed: show_info_dialog to gaim_gtkdialogs_info
2169         * Renamed: show_log_dialog to gaim_gtkdialogs_log
2170         * Renamed: show_warn_dialog to gaim_gtkdialogs_warn
2171         * Renamed: show_im_dialog to gaim_gtkdialogs_im
2172         * Renamed: gaim_gtkdialogs_new_im to gaim_gtkdialogs_im_with_user
2173         * Renamed: destroy_all_dialogs to gaim_gtkdialogs_destroy_all
2174         * Renamed: alias_dialog_bud to gaim_gtkdialogs_alias_buddy
2175         * Renamed: alias_dialog_contact to gaim_gtkdialogs_alias_contact
2176         * Renamed: alias_dialog_blist_chat to gaim_gtkdialogs_alias_chat
2177         * Renamed: show_confirm_del to gaim_gtkdialogs_remove_buddy
2178         * Renamed: show_confirm_del_group to gaim_gtkdialogs_remove_group
2179         * Renamed: show_confirm_del_blist_chat to gaim_gtkdialogs_remove_chat
2180         * Renamed: show_confirm_del_contact to gaim_gtkdialogs_remove_contact
2181         * Renamed: show_about to gaim_gtkdialogs_about
2182         * Added: gaim_notify_userinfo() and the associated notify_userinfo() UI op
2183                  which pass account and contact information associated with the
2184                  userinfo
2185
2186         Buddy List API:
2187         * Changed: gaim_blist_request_add_chat(), added name parameter
2188         * Added: gaim_contact_on_account()
2189         * Added: flags parameter to the GaimBlistNode struct
2190
2191         Conversation API:
2192         * Added: gaim_gtkconv_button_new()
2193
2194         Protocol Plugin API: v7
2195         * Added: chat_info_defaults to the GaimPluginProtocolInfo struct
2196
2197         Signals:
2198         * Added: conversation-updated for any update to the data associated
2199           with the conversation (topic, icon, adding to buddy list, etc.)
2200
2201         Conversation API:
2202         * Changed: gaim_conv_chat_add_user() (added new_arrival parameter)
2203
2204 version 0.81 (08/05/2004):
2205         Commands API:
2206         * Most functions now have a void *data argument.
2207
2208         Blist API:
2209         * Added: gaim_buddy_get_contact_alias
2210         * Renamed: gaim_get_buddy_alias to gaim_buddy_get_alias
2211         * Renamed: gaim_get_buddy_alias_only to gaim_buddy_get_alias_only
2212
2213         Conversation API:
2214         * Changed: gaim_conv_chat_add_user(), added flags parameter
2215         * Changed: gaim_conv_chat_add_users(), added GList of flags parameter
2216         * Changed: gaim_conv_chat_get_users(), now returns a GList of
2217           GaimConvChatBuddy's
2218         * Changed: gaim_conv_chat_set_users() now expects a GList of
2219           GaimConvChatBuddy's
2220         * Added: gaim_conv_chat_set_user_flags()
2221         * Added: gaim_conv_chat_get_user_flags()
2222         * Added: gaim_conv_chat_find_user()
2223         * Added: gaim_conv_chat_cb_new()
2224         * Added: gaim_conv_chat_cb_find()
2225         * Added: gaim_conv_chat_cb_destroy()
2226         * Added: gaim_conv_chat_cb_get_name()
2227
2228         Conversation UI ops:
2229         * Added: chat_update_user()
2230
2231         Signals:
2232         * Changed: chat-buddy-joining & chat-buddy-joined now include the user's flags
2233         * Changed: chat-buddy-joining & chat-buddy-leaving are now booleans, return
2234           TRUE if you don't want the join/leave to be displayed in the UI.
2235         * Added: chat-buddy-flags for when user's flags change
2236           gaim_marshal_VOID__POINTER_POINTER_POINTER_UINT_UINT (required for the new
2237           chat-buddy-flags signal)
2238         * Added: account-modified for when account settings have been changed.
2239
2240 version 0.80 (07/15/2004):
2241         Gaim API:
2242         * Removed: PRPL numbers : gaim_account_set_protocol(),
2243           gaim_account_get_protocol(), gaim_accounts_find_with_prpl_num,
2244           gaim_prpl_num_to_id(), gaim_prpl_id_to_num(), GaimProtocol
2245
2246         Protocol Plugin API: v6
2247         * Added: can_receive_file & send_file to the GaimPluginProtocolInfo struct
2248
2249         Signals:
2250         * Changed "chat-invited" to also include the components hash table so
2251           plugins can use serv_join_chat when the signal is emitted.
2252         * Added "chat-topic-changed" signal plugins know when a topic is changed.
2253
2254 version 0.79 (06/24/2004):
2255         Gaim API:
2256         * gaim_url_parse() now takes two additional parameters, which are used
2257           for returning the username and password from the URL, if they exist.
2258         * Added: has_focus UI op to GaimConversationUiOps and
2259           GaimConvWindowUiOps.
2260         * Added: gaim_conversation_has_focus() and gaim_conv_window_has_focus().
2261         * Removed: gaim_blist_save()
2262
2263         Protocol Plugin API: v5
2264         * Changed: add_buddy, add_buddies, remove_buddy, remove_buddies,
2265           rename_group and remove_group to take GaimBuddy's and
2266           GaimGroup's consistently.
2267         * Removed: OPT_PROTO_BUDDY_ICON (replaced by icon_spec)
2268         * Added: icon_spec to the GaimPluginProtocolInfo struct
2269
2270 version 0.78 (05/30/2004):
2271         Plugin API: v4
2272         * Added: actions - for plugins to add to the new Plugin Actions menu
2273
2274         Loader Plugin API: v2 (no changes)
2275
2276         Protocol Plugin API: v4
2277         * Removed: set_dir, get_dir and dir_search (not used, AIM-centric)
2278         * Removed: actions (replaced by generic plugin actions)
2279
2280         Perl Plugin API: v2 (no changes)
2281         TCL Plugin API: (no changes)
2282
2283         Signals:
2284         * Added: "blist-node-extended-menu" for extending Buddy, Chat and
2285                          Group right-click menus
2286         * Added: "drawing-tooltip" for plugins to allow plugins to change text
2287                          appearing in tooltips
2288         * Added: "gtkblist-created"
2289         * Added: "receiving-im-msg" and "receiving-chat-msg" (these behave
2290                           exactly like received-*-msg used to)
2291         * Added: "buddy-idle-updated" signal, for when the idle time changes.
2292         * Changed: "received-im-msg" and "received-chat-msg" no longer pass
2293                            pointers to who, message and flags, and are now void.
2294         * Removed: "drawing-menu" - it was UI sepecific and
2295                            "blist-node-extended-menu" is superior
2296
2297 version 0.77 (04/22/2004):
2298         Loader & Protocol Plugins independantly versioned
2299         Plugin loading now checks versioning on plugins (Standard, Loader &
2300         Protocol)
2301         new GAIM_{PLUGIN,PRPL,LOADER}_API_VERSION constants
2302
2303         Plugin API: v3
2304         * Added: prefs_info for UI independant plugin prefs
2305
2306         Loader Plugin API: v2
2307         * Added: api_version at top of GaimPluginLoaderInfo struct
2308
2309         Protocol Plugin API: v2
2310         * Added: api_version at top of GaimPluginProtocolInfo struct
2311         * Added: chat_menu for protocol specific extensions to the chat menu
2312         * Removed: get_away "Nada used it. Pink elephants on parade."
2313         * Removed: protocol_prefs (replaced by generic plugin prefs_info)
2314
2315         Perl Plugin API: v2 (no changes)
2316         TCL API: (no changes)
2317
2318         Signals:
2319         * Added: "conversation-drag-ended"
2320
2321 version 0.76 (04/01/2004):
2322         Plugin API: v2
2323         Perl Plugin API: v2
2324         Loader Plugin API: (not versioned)
2325         Protocol Plugin API: (not versioned)
2326         * Added: protocol_prefs for protocol specific preferences
2327         * Added: reject_chat so protocols can act on chat invite rejection
2328
2329         TCL Plugin API: (not versioned)
2330         * Changes to plugin registration to show descriptions
2331