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