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