ChangeLog.API

   1 Pidgin and Finch: The Pimpin' Penguin IM Clients That're Good for the Soul
   2
   3 version 2.10.1:
   4         * No changes
   5
   6 version 2.10.0:
   7         libpurple:
   8                 Added:
   9                 * purple_srv_txt_query_destroy (accidentally left out of 2.8.0)
  10
  11         Pidgin:
  12                 Added:
  13                 * pidgin_dialogs_plugins_info (should not be used by anything but Pidgin)
  14
  15 version 2.9.0:
  16         libpurple:
  17                 Added:
  18                 * Hash table to PurpleConvChat struct, used to make
  19                   purple_conv_chat_cb_find O(1).
  20                 * ui_data pointer to PurpleConvChatBuddy struct.
  21                 * deleting-chat-buddy signal (conversation signals)
  22                 * pidgin_pixbuf_from_data
  23                 * pidgin_pixbuf_anim_from_data
  24                 * pidgin_pixbuf_new_from_file
  25                 * pidgin_pixbuf_new_from_file_at_size
  26                 * pidgin_pixbuf_new_from_file_at_scale
  27
  28                 Deprecated:
  29                 * purple_conv_chat_set_users
  30                 * PurpleConvChat in_room list
  31
  32 version 2.8.0 (06/07/2011):
  33         libpurple:
  34                 Added:
  35                 * account-authorization-requested-with-message signal (Stefan Ott)
  36                   (#8690)
  37                 * cleared-message-history signal (conversation signals)
  38                 * purple_account_add_buddy_with_invite
  39                 * purple_account_add_buddies_with_invite
  40                 * purple_dnsquery_a_account
  41                 * purple_notify_user_info_add_pair_plaintext
  42                 * purple_media_get_active_local_candidates
  43                 * purple_media_get_active_remote_candidates
  44                 * purple_media_manager_get_video_caps (Jakub Adam) (#13095)
  45                 * purple_media_manager_set_video_caps (Jakub Adam) (#13095)
  46                 * purple_pounce_destroy_all_by_buddy (Kartik Mohta) (#1131)
  47                 * purple_proxy_connect_socks5_account
  48                 * purple_srv_resolve_account
  49                 * purple_txt_resolve_account
  50                 * Added add_buddy_with_invite to PurplePluginProtocolInfo
  51                 * Added add_buddies_with_invite to PurplePluginProtocolInfo
  52                 * Added PurpleSrvTxtQueryUiOps which allow UIs to specify their
  53                   own mechanisms to resolve SRV and/or TXT queries. It works
  54                   similar to PurpleDnsQueryUiOps
  55                 * purple_marshal_BOOLEAN__POINTER_BOOLEAN (kawaii.neko) (#12599)
  56
  57                 Deprecated:
  58                 * purple_account_add_buddy
  59                 * purple_account_add_buddies_with_invite
  60                 * purple_dnsquery_a
  61                 * purple_proxy_connect_socks5
  62                 * purple_srv_resolve
  63                 * purple_txt_resolve
  64                 * add_buddy from PurplePluginProtocolInfo struct
  65                 * add_buddies from PurplePluginProtocolInfo struct
  66
  67         Pidgin:
  68                 Added:
  69                 * pidgin_make_scrollable (Gabriel Schulhof) (#10599)
  70                 * chat-nick-clicked signal (kawaii.neko) (#12599)
  71                 * chat-nick-autocomplete signal (kawaii.neko) (#12599)
  72
  73 version 2.7.11 (03/10/2011):
  74         * libpurple:
  75                 Added:
  76                 * Four entries in the GHashTable passed when joining
  77                   an XMPP chat room which allow the UI to request a limited
  78                   amount of history.  See XEP-0045 7.1.16 for details; the
  79                   entries are named history_maxchars, history_maxstanzas,
  80                   history_seconds, and history_since.  history_since must be
  81                   interpretable by purple_str_to_time, and the prpl takes care
  82                   of formatting the time properly.
  83         * Perl:
  84                 Added:
  85                 * Purple::find_conversation_with_account
  86                 * Purple::Conversation::Chat::send_with_flags
  87                 * Purple::Conversation::IM::send_with_flags
  88
  89 version 2.7.10 (02/06/2011):
  90         * No changes
  91
  92 version 2.7.9 (12/26/2010):
  93         * No changes
  94
  95 version 2.7.8 (12/19/2010):
  96         * No changes
  97
  98 version 2.7.7 (11/23/2010):
  99         * No changes
 100
 101 version 2.7.6 (11/21/2010):
 102         * No changes
 103
 104 version 2.7.5 (10/31/2010):
 105         * No changes
 106
 107 version 2.7.4 (10/20/2010):
 108         Perl:
 109                 Added:
 110                 * Purple::BuddyList::Chat::get_components
 111
 112                 Changed:
 113                 * Purple::BuddyList::Chat::new now works properly.  Thanks
 114                   to Rafael in devel@conference.pidgin.im for reporting and
 115                   testing.
 116
 117 version 2.7.3 (08/10/2010):
 118         libpurple:
 119                 Fixed:
 120                 * purple_account_[gs]et_public_alias no longer crash when
 121                   called for a protocol that doesn't support the underlying
 122                   calls and the caller does not specify a failure callback.
 123
 124         Perl:
 125                 Added:
 126                 * Exposed log-subsystem signals.
 127
 128         Pidgin:
 129                 Changed:
 130                 * Changing the visibility (gtk_widget_hide/show) of
 131                   the widgets in the GtkIMHtmlToolbar should now affect
 132                   the visibility of the entries in the 'lean' view
 133                   (the default toolbar view).
 134
 135                 Deprecated:
 136                 * pidgin_check_if_dir
 137
 138         libgnt:
 139                 Added:
 140                 * gnt_tree_row_get_key, gnt_tree_row_get_next,
 141                   gnt_tree_row_get_prev, gnt_tree_row_get_child and
 142                   gnt_tree_row_get_parent.
 143
 144 version 2.7.2 (07/21/2010):
 145         * No changes
 146
 147 version 2.7.1 (05/29/2010):
 148         * No changes
 149
 150 version 2.7.0 (05/12/2010):
 151         libpurple:
 152                 Added:
 153                 * Account signals (see account-signals.dox); useful for D-Bus
 154                    * account-signed-on
 155                    * account-signed-off
 156                    * account-connection-error
 157                 * purple_account_get_name_for_display
 158                 * purple_account_get_privacy_type
 159                 * purple_account_get_public_alias
 160                 * purple_account_set_privacy_type
 161                 * purple_account_set_public_alias
 162                 * buddy-caps-changed blist signal
 163                 * Added media_caps to the PurpleBuddy struct
 164                 * purple_buddy_get_media_caps
 165                 * purple_buddy_set_media_caps
 166                 * purple_certificates_import for importing multiple
 167                   certificates from a single file (and corresponding
 168                   import_certificates member of PurpleCertificateScheme struct)
 169                 * autojoin connection signal
 170                 * purple_contact_get_group
 171                 * sent-attention conversation signal
 172                 * got-attention conversation signal
 173                 * ui-caps-changed media manager signal
 174                 * purple_media_candidate_copy
 175                 * purple_media_codec_copy
 176                 * purple_media_manager_get_backend_type
 177                 * purple_media_manager_set_backend_type
 178                 * PurpleMood struct in status.h
 179                 * purple_network_get_all_local_system_ips, which returns all
 180                   local IPs on the system.  On systems with the getifaddrs()
 181                   function, this will return both IPv4 and IPv6 addresses
 182                   (excluding link-local and loopback addresses).  On others,
 183                   it returns just IPv4 addresses.
 184                 * purple_network_listen_family and
 185                   purple_network_listen_range_family.  These will replace the
 186                   versions without _family in 3.0.0 and allow the caller to
 187                   specifically request either an IPv4 or IPv6 socket.  IPv6 is
 188                   only supported if the getaddrinfo() function is available
 189                   at build-time (not the case on Windows, currently).
 190                 * purple_prpl_got_media_caps
 191                 * purple_request_action_with_icon
 192                 * purple_request_action_with_icon_varg
 193                 * purple_socket_get_family
 194                 * purple_socket_speaks_ipv4
 195                 * purple_unescape_text
 196                 * purple_uuid_random
 197                 * purple_xfer_get_thumbnail
 198                 * purple_xfer_get_thumbnail_mimetype
 199                 * purple_xfer_set_thumbnail
 200                 * purple_xfer_prepare_thumbnail
 201
 202         Pidgin:
 203                 Added:
 204                 * pidgin_dialogs_buildinfo (should not be used by anything but Pidgin)
 205                 * pidgin_dialogs_developers (should not be used by anything but Pidgin)
 206                 * pidgin_dialogs_translators (should not be used by anything but Pidgin)
 207                 * gtk_imhtmltoolbar_switch_active_conversation
 208                 * 'paste' signal for GtkIMHtml (more in gtkimhtml-signals.dox)
 209                 * 'drawing-buddy' signal for gtkblist (more in gtkblist-signals.dox)
 210
 211 version 2.6.6 (02/18/2010):
 212         libpurple:
 213                 Changed:
 214                 * purple_xfer_cancel_local is now called instead of
 215                   purple_xfer_request_denied if an error is found when selecting
 216                   a file to send. Request denied is still used when a receive
 217                   request is not allowed.
 218                 * xmlnode_from_str now properly handles parsing an attribute which
 219                   contain "&lt;br&gt;", which were previously transformed into a
 220                   newline character (libxml2 unescapes all entities except
 221                   representations of '&', and libpurple's purple_unescape_html
 222                   converts "<br>" to a newline).
 223
 224         Perl:
 225                 Changed:
 226                 * Corrected the package names for the PurpleProxyType and
 227                   PurpleLogReadFlags enums to have the correct number of colons
 228                   (from Purple::ProxyType::::<type> to Purple::ProxyType::<type>
 229                   and Purple::Log:ReadFlags::::<type> to
 230                   Purple::Log::ReadFlags::<type>)  (Chris Foote)
 231
 232 version 2.6.5 (01/08/2010):
 233         No changes
 234
 235 version 2.6.4 (11/29/2009):
 236         No changes
 237
 238 version 2.6.3 (10/16/2009):
 239         No changes
 240
 241 version 2.6.2 (09/05/2009):
 242         Perl:
 243                 Added:
 244                 * Purple::XMLNode::get_next(), which returns the next neighbor tag of
 245                   the current node.
 246                 Changed:
 247                 * Purple::XMLNode::get_child() will return the first child node if
 248                   passed "" or undef as the name of the node.
 249
 250 version 2.6.1 (08/18/2009):
 251         No changes
 252
 253 version 2.6.0 (08/18/2009):
 254         libpurple:
 255                 Added:
 256                 * PurpleMedia and PurpleMediaManager API
 257                 * PURPLE_BLIST_NODE
 258                 * PURPLE_GROUP
 259                 * PURPLE_CONTACT
 260                 * PURPLE_BUDDY
 261                 * PURPLE_CHAT
 262                 * Account signals (see account-signals.dox)
 263                         * account-actions-changed
 264                         * account-created
 265                         * account-destroying
 266                 * blist-node-added and blist-node-removed signals (see
 267                   blist-signals.dox)
 268                 * Three Blist UI ops used to overload libpurple's built-in saving
 269                   of the buddy list to blist.xml. If a UI implements these, it probably
 270                   wants to add the buddies itself and not call purple_blist_load.
 271                 * Three File Transfer UI ops used to overload libpurple's use of fread
 272                   and fwrite for saving a file locally. These allow a UI to stream a
 273                   file through a socket without buffering the file on the local disk.
 274                 * Jabber plugin signals (see jabber-signals.dox)
 275                 * purple_account_remove_setting
 276                 * purple_buddy_destroy
 277                 * purple_buddy_get_protocol_data
 278                 * purple_buddy_set_protocol_data
 279                 * purple_buddy_get_local_buddy_alias
 280                 * purple_blist_get_buddies
 281                 * purple_blist_get_ui_data
 282                 * purple_blist_set_ui_data
 283                 * purple_blist_node_get_ui_data
 284                 * purple_blist_node_set_ui_data
 285                 * purple_certificate_check_signature_chain_with_failing
 286                 * purple_chat_destroy
 287                 * purple_connection_get_protocol_data
 288                 * purple_connection_set_protocol_data
 289                 * purple_contact_destroy
 290                 * purple_conv_chat_invite_user
 291                 * purple_debug_is_unsafe
 292                 * purple_debug_is_verbose
 293                 * purple_debug_set_unsafe
 294                 * purple_debug_set_verbose
 295                 * purple_global_proxy_set_info
 296                 * purple_group_destroy
 297                 * purple_ipv4_address_is_valid
 298                 * purple_ipv6_address_is_valid
 299                 * purple_log_get_activity_score
 300                 * purple_markup_is_rtl
 301                 * purple_markup_escape_text
 302                 * purple_network_convert_idn_to_ascii
 303                 * purple_network_force_online
 304                 * purple_network_set_stun_server
 305                 * purple_network_set_turn_server
 306                 * purple_network_get_stun_ip
 307                 * purple_network_get_turn_ip
 308                 * purple_network_remove_port_mapping
 309                 * purple_plugins_get_search_paths
 310                 * purple_proxy_connect_udp
 311                 * purple_prpl_get_media_caps
 312                 * purple_prpl_got_account_actions
 313                 * purple_prpl_initiate_media
 314                 * purple_request_field_get_group
 315                 * purple_request_field_get_ui_data
 316                 * purple_request_field_set_ui_data
 317                 * purple_ssl_connect_with_ssl_cn
 318                 * purple_strequal
 319                 * purple_utf8_strip_unprintables
 320                 * purple_util_fetch_url_request_len_with_account
 321                 * purple_xfer_prpl_ready
 322                 * purple_xfer_ui_ready
 323                 * xmlnode_from_file
 324                 * xmlnode_get_parent
 325                 * xmlnode_set_attrib_full
 326                 * PURPLE_STATUS_MOOD as a new PurpleStatusPrimitive
 327
 328                 Changed:
 329                 * xmlnode_remove_attrib now removes all attributes with the
 330                   same name.  Previously, it would remove the first one found,
 331                   which was completely non-deterministic.  If you want to remove
 332                   the attribute with no namespace, then use NULL with
 333                   xmlnode_remove_with_namespace.
 334                 * Plugins may now emit the jabber-sending-xmlnode signal in order
 335                   to send stanzas; this method is preferred to the prpl send_raw
 336                   function as other plugins listening to the signal see them.
 337                 * The conversation-updated signal with a PURPLE_CONV_UPDATE_TYPING
 338                   update type is emitted when receiving an IM.  Previously, the
 339                   typing state was modified (and the buddy-typing-stopped signal
 340                   emitted), but this signal was not emitted.
 341                 * Added a client_type field in the get_ui_info core UI op. See
 342                   core.h for details.
 343                 * Added introspection of signals exposed via the D-Bus API.
 344                 * purple_find_buddies is now more efficient in the case where
 345                   it is enumerating all the buddies for an account.
 346                 * purple_find_group is now more efficient for large numbers of groups.
 347                 * purple_find_conversation_with_account is more efficient for large
 348                   numbers of concurrent conversations.
 349                 * All DNS routines support internationalized domain names (IDNs) when
 350                   libpurple is compiled with GNU libidn.
 351                 * status is set before emitting signals in purple_xfer_set_status.
 352                 * Creating multiple distinct chats with the same name (i.e. "MSN Chat")
 353                   is deprecated and will be removed in libpurple 3.0.0.
 354                 * purple_xfer_start now accepts -1 as the fd parameter if the protocol
 355                   plugin will administer the transfer itself. 0 is still accepted for
 356                   backward compatibility since older versions of libpurple will not
 357                   accept -1.
 358
 359                 Deprecated:
 360                 * buddy-added and buddy-removed blist signals
 361                 * purple_blist_destroy
 362                 * purple_blist_new
 363                 * purple_buddy_get_local_alias
 364                 * purple_certificate_check_signature_chain
 365                 * purple_ip_address_is_valid
 366                 * purple_notify_user_info_remove_entry
 367                 * purple_set_blist
 368                 * purple_status_type_set_primary_attr
 369                 * purple_status_type_add_attr
 370                 * purple_status_type_add_attrs
 371                 * purple_status_type_add_attrs_vargs
 372                 * purple_status_type_get_primary_attr
 373                 * purple_status_set_attr_boolean
 374                 * purple_status_set_attr_int
 375                 * purple_status_set_attr_string
 376                 * purple_presence_add_status
 377                 * purple_presence_add_list
 378                 * purple_util_fetch_url_request_len
 379                 * xmlnode_set_attrib_with_namespace
 380                 * xmlnode_set_attrib_with_prefix
 381
 382         pidgin:
 383                 Added:
 384                 * gtk_imhtml_class_register_protocol
 385                 * gtk_imhtml_link_get_url, gtk_imhtml_link_get_text_tag,
 386                   gtk_imhtml_link_activate functions to process GtkIMHtmlLink
 387                   objects from GtkIMHtml protocol callbacks.
 388                 * gtk_imhtml_set_return_inserts_newline
 389                 * gtk_imhtml_set_populate_primary_clipboard
 390                 * pidgin_blist_set_theme
 391                 * pidgin_blist_get_theme
 392                 * pidgin_prefs_labeled_password
 393                 * pidgin_smiley_editor_set_data
 394                 * pidgin_sound_is_customized
 395                 * pidgin_utils_init, pidgin_utils_uninit
 396                 * pidgin_notify_pounce_add
 397                 * PidginBlistTheme, PidginBlistThemeLoader API
 398                 * PidginIconTheme, PidginStatusIconTheme, PidginIconThemeLoader
 399                   API
 400                 * pidgin_stock_id_from_status_primitive
 401                 * pidgin_stock_id_from_presence
 402
 403         libgnt:
 404                 Added:
 405                 * GntProgressBar and functions (Saleem Abdulrasool)
 406
 407         perl:
 408                 Added:
 409                 * Purple::XMLNode::get_name()
 410
 411                 Changed:
 412                 * Made a bunch of functions act more perl-like. Call the new()
 413                   functions as Class->new(...) instead of Class::new(...):
 414                         * Purple::Request::Fields::new
 415                         * Purple::Request::Field::new
 416                         * Purple::Request::Field::account_new
 417                         * Purple::Request::Field::bool_new
 418                         * Purple::Request::Field::choice_new
 419                         * Purple::Request::Field::int_new
 420                         * Purple::Request::Field::label_new
 421                         * Purple::Request::Field::list_new
 422                         * Purple::Request::Field::string_new
 423                         * Purple::Request::Field::group_new
 424                 * Make the XMLNode API more perl-like. Don't pass len
 425                   parameters and call them like:
 426                         * $xmlnode->copy()
 427                         * $xmlnode->to_str()
 428                         * $xmlnode->to_formatted_str()
 429                         * Purple::XMLNode::from_str(...)
 430 version 2.5.9 (08/18/2009):
 431         No changes
 432
 433 version 2.5.8 (06/27/2009):
 434         No changes
 435
 436 version 2.5.7 (06/20/2009):
 437         No changes
 438
 439 version 2.5.6 (05/19/2009):
 440         No changes
 441
 442 version 2.5.5 (03/01/2009):
 443         libpurple:
 444                 Changed:
 445                 * purple_status_type_new now defaults "saveable" to TRUE.
 446                   This was necessary in order to maintain the current behavior
 447                   while fixing non-saveable statuses not to be saved.
 448                 * xmlnode_get_prefix, xmlnode_to_str and xmlnode_to_formatted_str
 449                   now all take a const xmlnode* instead of an xmlnode*
 450
 451 version 2.5.4 (01/12/2009):
 452         perl:
 453                 Changed:
 454                 * Purple::PluginPref->get_bounds no longer takes two integer
 455                   arguments it now returns two integers.
 456
 457                 Removed:
 458                 * Removed a handful of string-related utility functions that
 459                   can generally be better handled with perl's built-in string
 460                   functions rather than using pidgin's:
 461                         * Purple::Util::strcasereplace
 462                         * Purple::Util::strcasestr
 463                         * Purple::Util::strreplace
 464                         * Purple::Util::str_strip_char
 465                         * Purple::Util::chrreplace
 466
 467 version 2.5.3 (12/20/2008):
 468         libpurple
 469                 Changed:
 470                 * purple_util_fetch_url and purple_util_fetch_url_request can
 471                   now fetch https URLs
 472
 473 version 2.5.0 (08/18/2008):
 474         libpurple:
 475                 Added:
 476                 * Connection flag PURPLE_CONNECTION_ALLOW_CUSTOM_SMILEY to indicate
 477                   that the connection supports sending and receiving custom smileys.
 478                 * PurpleSmiley and the Smiley API.
 479                 * purple_serv_got_join_chat_failed
 480                 * chat-join-failed signal (see conversation-signals.dox)
 481                 * chat-invite-blocked and blocked-im-msg signals (see
 482                   converation-signals.dox) (Thanks to Stefan Ott)
 483                 * purple_blist_update_node_icon
 484                 * purple_buddy_icons_node_has_custom_icon
 485                 * purple_buddy_icons_node_find_custom_icon
 486                 * purple_buddy_icons_node_set_custom_icon
 487                 * purple_buddy_icons_node_set_custom_icon_from_file
 488                 * purple_notify_user_info_prepend_section_break
 489                 * purple_notify_user_info_prepend_section_header
 490                 * "website" and "dev_website" items to the ui_info hash table
 491                 * purple_cmds_get_handle, purple_cmds_init, purple_cmds_uninit
 492                 * cmd-added and cmd-removed signals
 493                 * purple_get_host_name
 494                 * purple_util_fetch_url_len (temporary function overload to add max_len param)
 495                 * purple_util_fetch_url_request_len
 496                 * purple_prpl_send_attention
 497                 * purple_prpl_got_attention
 498                 * purple_prpl_got_attention_in_chat
 499
 500                 Deprecated:
 501                 * purple_blist_update_buddy_icon
 502                 * purple_buddy_icons_has_custom_icon
 503                 * purple_buddy_icons_find_custom_icon
 504                 * purple_buddy_icons_set_custom_icon
 505                 * pidgin_set_custom_buddy_icon
 506                 * purple_util_fetch_url_len
 507                 * purple_util_fetch_url_request_len
 508                 * serv_send_attention
 509                 * serv_got_attention
 510
 511                 Changed:
 512                 * xmlnode_copy now copies the prefix and namespace map for nodes.
 513
 514         pidgin:
 515                 Added:
 516                 * gtk_imhtml_smiley_create, gtk_imhtml_smiley_reload and
 517                   gtk_imhtml_smiley_destroy to deal with GtkIMHtmlSmiley's.
 518                 * pidgin_pixbuf_from_imgstore to create a GdkPixbuf from a
 519                   PurpleStoredImage.
 520                 * pidgin_themes_smiley_themeize_custom to associate custom smileys to
 521                   a GtkIMHtml widget.
 522                 * GTK_IMHTML_CUSTOM_SMILEY flag for GtkIMHtml.
 523                 * GTK+ Custom Smiley API.
 524
 525 version 2.4.2 (05/17/2008):
 526         perl:
 527                 Added:
 528                 * Purple::Prefs::get_children_names.
 529                 * Purple::timeout_remove.
 530                 Changed:
 531                 * Purple::timeout_add now returns a handle which can be used
 532                   to remove the timeout.
 533                 * Callbacks to Purple::Util::fetch_url and the
 534                   Purple::Request::* functions can now be specified as both
 535                   strings (the name of the callback function) and as coderefs.
 536         Finch:
 537                 libgnt:
 538                 * Added gnt_bindable_check_key to check if a keystroke is bound.
 539
 540 version 2.4.0 (02/29/2008):
 541         libpurple:
 542                 Added:
 543                 * purple_certificate_add_ca_search_path. (Florian Quèze)
 544                 * purple_gai_strerror.
 545                 * purple_major_version, purple_minor_version,
 546                   purple_micro_version variables are exported by version.h,
 547                   giving the version of libpurple in use at runtime.
 548                 * purple_util_set_current_song, purple_util_format_song_info
 549                 * purple_ip_address_is_valid
 550                 * Some accessor functions to the Roomlist API:
 551                         * purple_roomlist_get_fields
 552                         * purple_roomlist_room_get_type
 553                         * purple_roomlist_room_get_name
 554                         * purple_roomlist_room_get_parent
 555                         * purple_roomlist_room_get_fields
 556                         * purple_roomlist_field_get_type
 557                         * purple_roomlist_field_get_label
 558                         * purple_roomlist_field_get_hidden
 559                 * unlocalized_name field in PurpleAttentionType for UIs that need it.
 560                 * Some accessor and mutator functions for PurpleAttentionType:
 561                         * purple_attention_type_set_name
 562                         * purple_attention_type_set_incoming_desc
 563                         * purple_attention_type_set_outgoing_desc
 564                         * purple_attention_type_set_icon_name
 565                         * purple_attention_type_set_unlocalized_name
 566                         * purple_attention_type_get_name
 567                         * purple_attention_type_get_incoming_desc
 568                         * purple_attention_type_get_outgoing_desc
 569                         * purple_attention_type_get_icon_name
 570                         * purple_attention_type_get_unlocalized_name
 571                 * Add some PurpleBuddyListNode accessor functions:
 572                         * purple_blist_node_get_parent
 573                         * purple_blist_node_get_first_child
 574                         * purple_blist_node_get_sibling_next
 575                         * purple_blist_node_get_sibling_prev
 576                 * Added last_received to PurpleConnection, the time_t of the
 577                   last received packet.
 578                 * Added some more accessor functions:
 579                         * purple_chat_get_account
 580                         * purple_chat_get_components
 581                         * purple_connection_get_prpl
 582                         * purple_xfer_get_start_time
 583                         * purple_xfer_get_end_time
 584                 * purple_serv_got_private_alias for prpls to call after receiving a
 585                   private alias from the server.
 586
 587         Pidgin:
 588                 Added:
 589                 * pidgin_create_dialog to create a window that closes on escape. Also
 590                   added utility functions pidgin_dialog_get_vbox_with_properties,
 591                   pidgin_dialog_get_vbox, pidgin_dialog_get_action_area to access the
 592                   contents in the created dialog. (Peter 'fmoo' Ruibal)
 593                 * pidgin_dialog_add_button to add buttons to a dialog created by
 594                   pidgin_create_dialog.
 595                 * GTK_IMHTML_NO_SMILEY for GtkIMHtmlOptions means not to look for
 596                   smileys in the text. (Florian 'goutnet' Delizy)
 597                 * pidgin_auto_parent_window to make a window transient for a suitable
 598                   parent window.
 599                 * pidgin_tooltip_setup_for_treeview, pidgin_tooltip_destroy,
 600                   pidgin_tooltip_show and pidgin_tooltip_setup_for_widget to simplify
 601                   the process of drawing tooltips.
 602                 * pidgin_add_widget_to_vbox to simplify adding a labeled widget to a
 603                   window.
 604
 605                 Deprecated:
 606                 * PIDGIN_DIALOG
 607
 608         Finch:
 609                 * finch_roomlist_get_ui_ops and finch_roomlist_show_all
 610                 * finch_request_field_get_widget to get the widget for a request
 611                   field.
 612                 * finch_blist_get_tree to get the GntTree widget representing the
 613                   buddy list.
 614                 * FinchBlistManager structure to manage the buddylist view, and some
 615                   util functions finch_blist_install_manager,
 616                   finch_blist_uninstall_manager, finch_blist_manager_find and
 617                   finch_blist_manager_add_node.
 618                 * Added finch_log_show, finch_log_show_contact, finch_syslog_show,
 619                   finch_log_init, finch_log_get_handle, finch_log_uninit
 620
 621                 libgnt:
 622                 * Added gnt_tree_set_row_color to set the color for a row in a tree.
 623                 * Added gnt_style_get_string_list
 624                 * Added gnt_color_add_pair to define a new color.
 625                 * Added gnt_colors_get_color to get an ncurses color value from a
 626                   string.
 627                 * Added gnt_style_get_color to get a color pair from an entry in
 628                   ~/.gntrc
 629                 * Added gnt_tree_get_parent_key to get the key for the parent row.
 630
 631 version 2.3.0 (11/24/2007):
 632         libpurple:
 633                 Added:
 634                 * a PurpleConversation field and an alias field in PurpleConvMessage
 635                 * account-authorization signals (see account-signals.dox for
 636                   details) (Stefan Ott)
 637                 * libpurple/purple.h, which includes #define's and #include's
 638                   required to compile stand-alone plugins
 639                 * PURPLE_STATUS_TUNE as a new PurpleStatusPrimitive
 640                 * purple_plugin_disable(), which is intended to be called when
 641                   a purple_plugin_unload()--which was called when a user tried
 642                   to unload a plugin--fails.  This then prevents the plugin
 643                   from being saved in the saved plugins list, so it'll won't
 644                   be loaded at the next startup.
 645                 * PurpleDisconnectReason enumeration of machine-readable
 646                   types of connection error.
 647                 * purple_connection_error_reason(), to be used by prpls
 648                   (instead of purple_connection_error() and setting
 649                   gc->wants_to_die) to report errors along with a
 650                   PurpleDisconnectReason.
 651                 * PurpleConnectionUiOps.report_disconnect_reason, to be
 652                   implemented by UIs (rather than .report_disconnect) if
 653                   they want to use the reported PurpleDisconnectReason
 654                   to give a more specific error.
 655                 * A connection-error signal, fired just after the UiOp is
 656                   called with the same information.
 657                 * purple_connection_reason_is_fatal(), acting as a hint
 658                   to whether automatic reconnection should be attempted
 659                   after a connection error (rather than checking
 660                   gc->wants_to_die).
 661                 * PurpleConnectionErrorInfo, a struct to hold a
 662                   PurpleConnectionError and a const char *description.
 663                 * purple_account_get_current_error() to get the most recent
 664                   PurpleConnectionError and description (or NULL if the
 665                   account is happy with life), to allow bits of the UI to know
 666                   the last error without caching it themselves (as
 667                   PidginBuddyList does).
 668                 * purple_account_clear_current_error() to reset an account's
 669                   error state to NULL.
 670                 * An account-error-changed signal, firing when
 671                   purple_account_get_current_error()'s return value changes.
 672
 673                 * PidginMiniDialog, a Gtk widget-ified version of
 674                   pidgin_make_mini_dialog().
 675
 676                 * purple_util_init()
 677                 * purple_util_uninit()
 678
 679                 * purple_network_listen_map_external() to temporarily disable
 680                   mapping ports externally via NAT-PMP or UPnP.
 681
 682                 Changed:
 683                 * purple_plugin_unload() now honors the return value of a
 684                   plugin's unload function and can actually return FALSE now.
 685                 * purple_plugin_unload() no longer does its own notifications
 686                   when a dependent plugin fails to unload.  The UI should do
 687                   something appropriate.
 688
 689                 * pidgin_make_mini_dialog() now declares its return type to be
 690                   GtkWidget * rather than void *.  This should not break any
 691                   existing code since any code using it must already rely on
 692                   the return type actually being GtkWidget * all along.
 693
 694                 Deprecated:
 695                 * pidgin_dialogs_about()
 696                 * pidgin_log_show_contact()
 697                 * pidgin_log_show()
 698                 * pidgin_plugin_dialog_show()
 699                 * pidgin_pounce_editor_show()
 700                 * pidgin_pounces_manager_show()
 701                 * pidgin_syslog_show()
 702
 703                 * purple_connection_error()
 704                 * pidgin_blist_update_account_error_state()
 705                 * PidginBuddyList.connection_errors
 706                 * purple_network_listen_map_external()
 707
 708                 MSN:
 709                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
 710                   PURPLE_TUNE_ARTIST, PURPLE_TUNE_ALBUM and PURPLE_TUNE_TITLE
 711                   attributes.
 712
 713                 XMPP:
 714                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
 715                   PURPLE_TUNE_{ARTIST, TITLE, ALBUM, GENRE, COMMENT, TRACK, TIME,
 716                   YEAR, URL} attributes.
 717
 718         Finch:
 719                 libgnt:
 720                 * Added gnt_color_pair, which will try to intelligenty set text
 721                   attributes in place of colors if the terminal doesn't have color
 722                   support. (Bug: #3560) All future code should use gnt_color_pair
 723                   instead of COLOR_PAIR.
 724                 * Added gnt_menuitem_set_id and gnt_menuitem_get_id to set and get the
 725                   string id of a menuitem respectively.
 726                 * Added gnt_window_get_accel_item, which returns a the id of a menuitem
 727                   bound to a keystroke.
 728                 * Added gnt_menu_get_item to get a menuitem of the given id from a
 729                   menu.
 730                 * Added gnt_menuitem_activate, which triggers the 'activate' signal on
 731                   the menuitem and calls the callback function, if available.
 732                 * Added GntEntryKillRing in GntEntry.
 733                 * Added gnt_window_set_maximize and gnt_window_get_maximize, and
 734                   GntWindowFlags enum.
 735
 736 version 2.2.2 (10/23/2007):
 737         libpurple:
 738                 Changed:
 739                 * The size parameter of purple_util_write_data_to_file_absolute
 740                   has been changed to gssize instead of a size_t to correctly
 741                   indicate that -1 can be used for a nul-delimited string.
 742                 * The documentation for purple_savedstatuses_get_popular used to
 743                   incorrectly claim that the active status is excluded from the
 744                   returned list. The documentation has been corrected. Also, the
 745                   function now returns a correct list when called with a value of 0.
 746
 747 version 2.2.0 (09/13/2007):
 748         libpurple:
 749                 Added:
 750                 * PURPLE_MESSAGE_INVISIBLE flag, which can be used by
 751                   purple_conv_im_send_with_flags to send a message, but not display it
 752                   in the conversation
 753                 * serv_send_attention(), serv_got_attention(), as well as send_attention
 754                   and attention_types in PurplePluginProtocolInfo. This new API is used
 755                   for zapping in MySpaceIM, buzzing in Yahoo, and nudging in MSN.
 756                 * PurpleConvMessage structure to represent a message in a
 757                   conversation. purple_conversation_message_get_sender,
 758                   purple_conversation_message_get_message,
 759                   purple_conversation_message_get_flags and
 760                   purple_conversation_message_get_timestamp to get information about a
 761                   PurpleConvMessage.
 762                 * purple_conversation_get_message_history() to retrieve a list of
 763                   PurpleConvMessage's in a conversation, and
 764                   purple_conversation_clear_message_history to clear the history.
 765                 * purple_certificate_* functions in libpurple/certificate.h - "A public-key certificate API"
 766                 * purple_ssl_get_peer_certificates() and associated field in PurpleSslOps to retrieve a server's presented SSL certificate chain.
 767                 * PurpleSslConnection::verifier to provide a "how to verify the peer's certificates" callback to the SSL handlers. See certificate.h for more on this.
 768                 * 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.
 769
 770                 Changed:
 771                 * purple_prefs_load is now called within purple_prefs_init.
 772                   The UI no longer needs to call it.
 773                 * writing-im-msg now receives the conversation name as the who
 774                   argument if the caller of purple_conversation_write didn't
 775                   provide a value for who.
 776
 777         Pidgin:
 778                 Added:
 779                 * pidgin_set_accessible_relations, sets up label-for and labelled-by
 780                   ATK relations (broken out from pidgin_set_accessible_label)
 781                 * pidgin_conv_attach_to_conversation, to reattach the Pidgin UI to a
 782                   conversation
 783                 * conversation-hiding and conversation-displayed signals.
 784                 * pidgin_text_combo_box_entry_new, pidgin_text_combo_box_entry_get_text
 785                   and pidgin_text_combo_box_entry_set_text
 786
 787                 Changed:
 788                 * pidgin_conversations_fill_menu now also adds a separator and a 'Show
 789                   All' item if there are more than one conversations in the list.
 790
 791         Finch:
 792                 Added:
 793                 * finch_sound_is_enabled
 794                 * The reserved field in the FinchConv is now used to store information
 795                   about the conversation (using FinchConversationFlag)
 796                 * finch_account_dialog_show
 797
 798                 libgnt:
 799                 * gnt_slider_set_small_step, gnt_slider_set_large_step to allow more
 800                   fine tuned updates of a GntSlider
 801                 * gnt_util_parse_xhtml_to_textview to parse XHTML strings in a
 802                   GntTextView (this works only if libxml2 is available)
 803
 804 version 2.1.1 (08/20/2007):
 805         libpurple:
 806                 Changed:
 807                 * PurpleAccountUiOps.request_authorize's authorize_cb and
 808                   deny_cb parameters now correctly have type
 809                   PurpleAccountRequestAuthorizationCb rather than GCallback.
 810                   (You'll want to change your UI's implementation's signature
 811                   to avoid warnings, and then remove some now-redundant casts
 812                   back to the proper type.)
 813
 814 version 2.1.0 (7/28/2007):
 815         libpurple:
 816                 Added:
 817                 * purple-remote: added getstatus command
 818                 * conversation-extended-menu signal (See Doxygen docs)
 819                 * OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
 820                   slash commands are "native" to the protocol
 821                 * PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
 822                   should not be auto-linkified
 823                 * PurpleEventLoopUiOps.timeout_add_seconds
 824                     UIs can now use better scheduling for whole-second timers.  For
 825                     example, clients based on the glib event loop can now use
 826                     g_timeout_add_seconds.
 827                 * purple_blist_node_get_type
 828                 * purple_conversation_do_command
 829                 * purple_conversation_get_extended_menu
 830                 * purple_core_ensure_single_instance
 831                     This is for UIs to use to ensure only one copy is running.
 832                 * purple_dbus_is_owner
 833                 * purple_timeout_add_seconds
 834                     Callers should prefer this to purple_timeout_add for timers
 835                     longer than 1 second away.  Be aware of the rounding, though.
 836                 * purple_xfer_get_remote_user
 837                 * purple_pounces_get_all_for_ui
 838                 * purple_prefs_get_children_names
 839                 * added displaying-email-notification and
 840                   displaying-emails-notification signals
 841
 842                 Changed:
 843                 * The documentation of the following functions now properly
 844                   declares that the returned value must not be modified or
 845                   freed, which was always the case:
 846                         * purple_accounts_get_all
 847                         * purple_connections_get_all
 848                         * purple_connections_get_connecting
 849                         * purple_conv_chat_get_ignored
 850                         * purple_conv_chat_get_users
 851                         * purple_get_chats
 852                         * purple_get_conversations
 853                         * purple_get_ims
 854                         * purple_notify_user_info_get_entries
 855                 * The following functions now return a GList* instead of a
 856                   const GList*, as const is not very useful with GLists.  The
 857                   returned value still must not be modified or freed:
 858                         * purple_account_get_status_types
 859                         * purple_mime_document_get_fields
 860                         * purple_mime_document_get_parts
 861                         * purple_mime_part_get_fields
 862                         * purple_request_fields_get_required
 863                         * purple_request_field_list_get_selected
 864                         * purple_request_field_list_get_items
 865                         * purple_status_type_get_attrs
 866                         * purple_presence_get_statuses
 867                 * purple_request_field_list_set_selected now takes a GList*
 868                   instead of a const GList* for items, as const is not very
 869                   useful with GLists.  The passed list is still not modified
 870                   or freed.
 871                 * purple_presence_add_list now takes a GList* instead of a
 872                   const GList* for source_list, as const is not very useful with
 873                   GLists.  The passed list is still not modified or freed.
 874
 875         Pidgin:
 876                 Added:
 877                 * gtk_imhtml_setup_entry
 878                 * pidgin_create_window
 879                 * pidgin_retrieve_user_info and pidgin_retrieve_user_info_in_chat,
 880                   shows immediate feedback when getting information about a user.
 881                 * gtk_imhtml_animation_new
 882                     Can be used for inserting an animated image into an IMHTML.
 883                 * pidgin_menu_position_func_helper
 884                 * pidgin_blist_get_name_markup, returns the buddy list markup
 885                   text for a given buddy.
 886                 * pidgin_blist_draw_tooltip and pidgin_blist_tooltip_destroy
 887                   for creating blist tooltips from outside of buddy list code
 888                 * pidgin_themes_remove_smiley_theme
 889
 890                 Changed:
 891                 * pidgin_append_menu_action returns the menuitem added to the menu.
 892                 * pidgin_separator returns the separator added to the menu.
 893                 * PidginConversation has struct members to handle the new info
 894                   pane:
 895                         * infopane
 896                         * infopane_hbox
 897                         * infopane_model
 898                         * infopane_iter
 899
 900         Finch:
 901                 Added:
 902                 * finch_retrieve_user_info
 903
 904                 libgnt:
 905                         Added:
 906                         * GntWS for workspaces
 907                         * gnt_tree_set_column_title
 908                         * GntSlider widget
 909                         * "completion" signal for GntEntry
 910                         * "terminal-refresh" signal for GntWM, with a corresponding entry
 911                           in GntWMClass
 912                         * New flags for GntTextView to decide whether to word-wrap or show
 913                           scrollbars (GntTextViewFlag) which can be set by
 914                           gnt_text_view_set_flag
 915                         * gnt_style_get_from_name
 916                         * gnt_window_present
 917                         * gnt_tree_set_column_width_ratio
 918                         * gnt_tree_set_column_resizable
 919                         * gnt_tree_set_column_is_right_aligned
 920                         * gnt_tree_set_search_function, gnt_tree_set_search_column,
 921                           gnt_tree_is_searching
 922                         * 'file-selected' signal is emited for GntFileSel
 923                         * gnt_style_parse_bool
 924                         * gnt_util_set_trigger_widget
 925
 926                         Changed:
 927                         * gnt_tree_get_rows() now returns a GList* instead of a const
 928                           GList*, as const is not very useful with GLists.  The
 929                           returned value still must not be modified or freed.
 930                         * Instead of keeping an 'invisible' item, the GntTreeColumns now
 931                           maintain 'flags' with the appropriate flags set
 932
 933 version 2.0.2 (6/14/2007):
 934         Pidgin:
 935                 Deprecated:
 936                 * pidgin_dialogs_alias_contact:  This will be removed in 3.0.0
 937                   unless there is sufficient demand to keep it.
 938
 939 version 2.0.0 (5/3/2007):
 940         Please note all functions, defines, and data structures have been
 941         re-namespaced to match the new names of Pidgin, Finch, and libpurple.
 942         All gaim_gtk_* functions are now pidgin_*, former libgaim functions are
 943         now purple_*.  Please consult our doxygen documentation for a complete
 944         reference.
 945
 946         The gaim-compat.h header exists to provide an API compatibility layer
 947         for libpurple functions.  As an API compatibility layer, it must be
 948         included at compile time to be of use.
 949
 950         Changed:
 951         * All the status stuff.  Yay!
 952         * gaim_prefs_connect_callback(), added handle parameter
 953         * gtk_imhtml_toolbar now descends from GtkHBox making it easier to add your
 954           own widgets to it
 955         * gaim_find_conversation_with_account, added a "type" parameter
 956         * gaim_gtk_prefs_labeled_spin_button, the "key" parameter is now a
 957           const char* instead of just a char*
 958         * gaim_gtk_prefs_labeled_entry, the "key" parameter is now a const char*
 959           instead of just a char*
 960         * the add_buddy perl sub.  The sub now takes the account as the first
 961           argument, and buddy and group as the second and third.  It also adds
 962           the buddy to the server-side buddy list of the given account.
 963         * gaim_connection_new, gaim_account_connect and gaim_account_register no
 964           longer return a GaimConnection
 965         * keep_alive in GaimConnection is renamed to keepalive
 966         * gaim_mkstemp, added a second argument, a boolean, of whether or not the
 967           file is binary
 968         * gaim_log_logger_new, rewritten
 969         * gaim_conv_window_remove_conversation()'s last argument to be a
 970           GaimConversation.
 971         * A new blocked icon: pixmaps/status/default/blocked.png
 972         * In pixmaps/status/default: extendedaway.png renamed to extended_away.png
 973         * In pixmaps/status/default: na.png renamed to unavailable.png
 974         * gtk_imhtml_toggle_bold(): No longer returns a value
 975         * gtk_imhtml_toggle_italic(): No longer returns a value
 976         * gtk_imhtml_toggle_underline(): No longer returns a value
 977         * gtk_imhtml_toggle_strike(): No longer returns a value
 978         * gtk_imhtml_scroll_to_end(): Added the smooth paramter
 979         * gaim_log_new(), added conv parameter
 980         * gaim_buddy_icon_new(), leaves a reference which the caller owns.  Use
 981           gaim_buddy_icon_unref() immediately if you don't want a reference (the
 982           old behavior).
 983         * GAIM_CONV_UNKNOWN to GAIM_CONV_TYPE_UNKNOWN.
 984         * GAIM_CONV_IM to GAIM_CONV_TYPE_IM.
 985         * GAIM_CONV_CHAT to GAIM_CONV_TYPE_CHAT.
 986         * GAIM_CONV_MISC to GAIM_CONV_TYPE_MISC.
 987         * GAIM_CONV_ANY to GAIM_CONV_TYPE_ANY.
 988         * GaimConversationUiOps.write_conv, Replaced const char *who with
 989           const char *name, const char *alias
 990         * gaim_conv_chat_add_users(), added extra_msgs and new_arrivals (pass NULL
 991           and FALSE respectively, to get the same behavior as before)
 992         * chat_add_users in GaimConversationUiOps, added cbuddies and
 993           new_arrivals and removed buddies.
 994         * chat_rename_user in GaimConversationUiOps, added new_alias
 995         * gaim_conv_chat_cb_new(), added alias. (pass NULL to get the same
 996           behavior as before).
 997         * GaimConversation.log became GList * GaimConversation.logs, so that a
 998           conversation can have multiple logs at once
 999         * gaim_conv_chat_add_user, added extra_msgs
1000         * gaim_notify_userinfo, removed primary and secondary parameters
1001         * GaimNotifyUiOps.notify_userinfo: removed title, primary, and
1002           secondary parameters
1003         * Idle timers are now added and removed in gtkidle.c in response
1004           to the signed-on and signed-off signals
1005         * GaimXfer->ops.read, GaimXfer->ops.write, gaim_xfer_set_read_fnc(),
1006           gaim_xfer_set_write_fnc(), gaim_xfer_read(), gaim_xfer_write():
1007           Changed ssize_t to gssize
1008         * serv_got_im, serv_got_chat_in, serv_send_im and serv_chat_send all use
1009           GaimMessageFlags instead of GaimConvImFlags / GaimConvChatFlags
1010         * All core<->prpl message passing now uses html.  This was previously true
1011           for receiving messages, it's now also true for sending them.  prpls that
1012           don't support html need to gaim_unescape_html() the message.
1013         * Notify API: GCallback -> GaimNotifyCloseCallback,
1014                       void *user_data -> gpointer user_data
1015         * gaim_notify_searchresults_get_rows_count,
1016           gaim_notify_searchresults_get_columns_count: return type now guint
1017         * gaim_account_notify_added: No longer checks if there is a
1018           GaimBuddy for the added user, that's left up to the prpls.  See the
1019           documentation for this function and gaim_account_request_add.
1020         * gaim_accounts_reorder: new_index is now a gint instead of a size_t
1021         * displaying-message signals: displaying-[im|chat]-msg and
1022           displayed-[im|chat]-msg signals are emitted for all messages
1023           (ie, for received messages, sent messages, system messages, error
1024           messages etc.), and the signals now have
1025           gaim_gtk_conversations_get_handle() for their handle.
1026         * GAIM_NOTIFY_BUTTON_ADD_BUDDY to GAIM_NOTIFY_BUTTON_ADD
1027         * conversation-switched: This signal has been moved from conversation to
1028                                  the UI and the signal-handlers only receive the
1029                                  conversation that has been switched to.
1030         * GaimPluginProtocolInfo: Added offline_message
1031         * GaimPluginProtocolInfo: Added whiteboard_prpl_ops
1032         * GaimPluginProtocolInfo: Added media_prpl_ops
1033         * GaimPluginProtocolInfo: Added "user_info" argument to tooltip_text,
1034                                   changed the return type to void
1035         * GaimPluginProtocolInfo: Added "full" argument to tooltip_text
1036         * gaim_pounce_new(): Added option argument for pounce options
1037         * gaim_network_listen() and gaim_network_listen_range(): Added
1038           socket_type parameter to allow creation of UDP listening. Modified
1039           to be asynchronous with a callback to allow for UPnP operation.
1040           Returns a data structure that can be used to cancel the listen
1041           attempt using gaim_network_listen_cancel()
1042         * GaimPrefCallback: val is now a gconstpointer instead of a gpointer
1043         * gtk_imhtml_get_current_format(): the arguments are now set to TRUE or
1044           FALSE.  Previously they were set to TRUE or left alone.  Also, you
1045           may now pass NULL if you're not interested in a specific formatting.
1046         * Smiley Themes: Backslashes must be backslash-escaped.
1047         * Plugins: Depedencies are now honored when unloading plugins.
1048         * gaim_markup_extract_info_field(): Added format_cb parameter.
1049         * gaim_markup_extract_info_field(): Changed GString parameter to a GaimNotifyUserInfo paramter.
1050         * gaim_str_to_time(): Added support for parsing the MM/DD/YYYY format.
1051         * gaim_plugin_action_new(): label is now const char *
1052         * gaim_plugin_pref_new_with_name(): name is now const char *
1053         * gaim_plugin_pref_new_with_label(): label is now const char *
1054         * gaim_plugin_pref_new_with_name_and_label(): name and label are
1055           now const char *
1056         * gaim_plugin_pref_set_name(): name is now const char *
1057         * gaim_plugin_pref_get_name(): return type is now const char *
1058         * gaim_plugin_pref_set_label(): label is now const char *
1059         * gaim_plugin_pref_get_label(): return type is now const char *
1060         * gaim_plugin_pref_add_choice(): label is now const char *
1061         * struct proto_chat_entry: label is now const char *
1062         * struct proto_chat_entry: identifier is now const char *
1063         * All network activity has been updated to use non-blocking sockets.
1064           This means that plugins must be updated to expect such a socket from
1065           gaim_proxy_connect() and gaim_network_listen*().
1066         * gaim_proxy_connect(): changed to return NULL on error and a pointer
1067           to a GaimProxyConnectInfo object which can be used to cancel
1068           connection attempts using gaim_proxy_connect_cancel().  Also added
1069           a 'handle' parameter that can be used to cancel the connection
1070           attempt using gaim_proxy_connect_cancel_with_handle().
1071         * gaim_gethostbyname_async(): Renamed to gaim_dnsquery_a() and
1072           changed to return a pointer to a data structure that can be
1073           used to cancel the pending DNS query using gaim_dnsquery_destroy()
1074         * gaim_url_fetch(): Renamed to gaim_util_fetch_url() and changed
1075           to return a pointer to a data structure that can be used to cancel
1076           the pending HTTP request using gaim_util_fetch_url_cancel().
1077           Corresponding callback has changed to accept this data structure
1078           as its first argument, and to accept an error message as an
1079           additional final argument.
1080         * gaim_gtk_create_imhtml(): Added sw_ret() parameter
1081         * gaim_account_get_log(): Added create parameter
1082         * GAIM_CMD_P_VERYHIGH is now GAIM_CMD_P_VERY_HIGH
1083         * gtk_imhtml_search_find(): Now wraps around to the top instead of
1084           clearing the search at the end.
1085         * gaim_gtkxfer_dialog_show: Can now take NULL to show (and possibly
1086           create) a default gtkxfer dialog.
1087         * CHAT_USERS_BUDDY_COLUMN became CHAT_USERS_WEIGHT_COLUMN, along with
1088           a change in the values stored in the column.
1089         * gaim_find_buddies() returns a list of all buddies in the account if name
1090           is NULL.
1091         * gaim_gtk_set_custom_buddy_icon() sets custom icon for a user.
1092         * Hid the definition of _GaimStringref, which already had a warning to
1093           avoid accessing it directly.
1094         * notify_userinfo() UI op is passed a GaimNotifyUserInfo instead of a char*
1095           for the user information
1096         * gaim_buddy_icon_get_scale_size() and was changed to ALWAYS scale
1097           the icon instead of only when icon_spec->scale_rules contains
1098           GAIM_ICON_SCALE_DISPLAY.  Callers should be changed to check the
1099           scale_rules before calling this function.
1100         * gaim_gtk_buddy_icon_get_scale_size() was changed to accept an
1101           additional parameter which is used to determine what kind of
1102           scaling should be done, if any.
1103         * purple_request_input(), purple_request_choice(),
1104           purple_request_choice_varg(), purple_request_action(),
1105           purple_request_action_varg(), purple_request_fields(),
1106           purple_request_yes_no(), purple_request_ok_cancel(),
1107           purple_request_accept_cancel(), purple_request_file(), and
1108           purple_request_folder() was changed to accept account, who, and
1109           conversation parameters for associating the request with an account, a
1110           buddy, or a conversation.
1111         * Significant changes to the buddy icon and imgstore APIs.  If you
1112           were using any of it, it's best to look at the header files or
1113           Doxygen documentation, but here are some significant changes:
1114             purple_buddy_icon_new() now takes ownership of ("frees") icon_data
1115             purple_buddy_icon_set_data(): likewise for data
1116             purple_buddy_icon_set_for_user(): likewise for data
1117             purple_buddy_icon_set_for_user() now takes a checksum parameter
1118             purple_imgstore_add() was renamed to purple_imgstore_add_with_id()
1119               which takes ownership of data
1120
1121         Removed:
1122         * gaim_gtk_sound_{get,set}_mute() (replaced by the /gaim/gtk/sound/mute
1123           preference)
1124         * gaim_escape_html(const char *html) (use g_markup_escape_text(html, -1)
1125           instead)
1126         * gaim_accounts_sync, account changes are now scheduled to be saved
1127           automatically
1128         * gaim_connection_connect
1129         * gaim_connection_disconnect
1130         * gaim_connection_register
1131         * gaim_accounts_auto_login
1132         * gaim_find_conversation, use gaim_find_conversation_with_account instead
1133         * gaim_chat_get_display_name
1134         * gaim_conversation_set_history, gaim_conversation_get_history, and
1135           GaimConversation->history.  Use gtk_imhtml_get_markup instead.
1136         * set_gaim_user_dir to gaim_util_set_user_dir
1137         * create_prpl_icon to gaim_gtk_create_prpl_icon
1138         * Window flashing support in the core: gaim_conv_window_flash, and flash UI
1139           operation for conversations.  Use signal "received-im-msg" or similar.
1140         * All warning stuff from the core.
1141         * gaim_gtkconv_get_dest_tab_at_xy(), instead use gaim_gtkconv_get_tab_at_xy()
1142         * chat_add_user from GaimConversationUiOps: only chat_add_users is used
1143         * chat_remove_user from GaimConversationUiOps: only chat_remove_users is used
1144         * uc from the GaimBuddy struct
1145         * gaim_sound_get_handle()
1146         * gaim_debug_vargs()
1147         * serv_add_buddy(); use gaim_account_add_buddy() instead
1148         * serv_add_buddies(); use gaim_account_add_buddies() instead
1149         * serv_change_passwd(); use gaim_account_change_password() instead
1150         * serv_close()
1151         * serv_finish_login()
1152         * serv_login()
1153         * serv_remove_buddy(); use gaim_account_remove_buddy() instead
1154         * serv_remove_buddies(); use gaim_account_remove_buddies() instead
1155         * serv_rename_group()
1156         * serv_set_buddyicon(): use gaim_account_set_buddy_icon() instead
1157         * serv_touch_idle(): use gaim_gtk_check_idle() instead
1158         * GaimGtkImPane->a_virgin
1159         * gaim_str_strip_cr(); use gaim_str_strip_char(str, '\r') instead
1160         * gaim_find_buddys_group renamed to gaim_buddy_get_group
1161         * gaim_gtkpounce_menu_build()
1162         * gaim_gtkpounce_dialog_show()
1163         * GaimGtkBuddyList->bpmenu
1164         * GaimConvImFlags and GaimConvChatFlags; use GaimMessageFlags instead
1165         * cb and user_data from the ops in GaimNotifyUiOps: This is now handled
1166           by the notify API in the core.
1167         * GaimConversationUiOps.updated: use the conversation-updated signal
1168         * GAIM_SUBTYPE_CONV_WINDOW: windows are now only represented in the UI,
1169           so GAIM_TYPE_BOXED is used for the signal types
1170         * gaim_gtk_privacy_is_showable(): We do fallback privacy in the core
1171           now, so this would always be TRUE now.
1172         * GaimBlistNodeAction: See GaimMenuAction
1173         * gaim_blist_node_action_new(); use gaim_menu_action_new() instead
1174         * gaim_date()
1175         * gaim_date_full(): See gaim_date_format_full()
1176         * gaim_strftime(): See gaim_utf8_strftime()
1177         * GAIM_MESSAGE_COLORIZE
1178         * user_data from gaim_notify_searchresults_new_rows and from
1179           notify_searchresults in GaimNotifyUiOps.
1180         * gaim_conversation_get_send_history(), and send_history from
1181           GaimConversation
1182         * Removed ui_ops from GaimBuddyList. Use gaim_blist_get_ui_ops() instead
1183         * GaimGtkConversation: dialogs (dialogs.search moved to GaimGtkWindow)
1184         * gaim_show_xfer_dialog: Use gaim_gtk_xfer_dialog_show(NULL) instead.
1185         * GaimGtkRoomlistDialog: Nothing used it outside of the file it was in.
1186         * gaim_gtk_roomlist_dialog_new: use gaim_gtk_roomlist_show
1187         * gaim_gtk_roomlist_dialog_new_with_account: use gaim_gtk_roomlist_show_with_account
1188         * binreloc functions
1189
1190         Added:
1191         * gaim_prefs_disconnect_by_handle()
1192         * a password field to GaimConnection, which only persists for the
1193           session (when "remember password" is false, account->password is
1194           NEVER set) Use gaim_connection_get_password(GaimConnection *gc)
1195         * gaim_log_common_writer, gaim_log_common_lister, gaim_log_common_sizer,
1196           and gaim_log_get_log_dir to allow log formats that use standard Gaim
1197           log directory to use Gaim's built-in code for these purposes.
1198         * GaimLogCommonLoggerData struct for a basic logger_data struct to be
1199           used with "common" logger functions.
1200         * gaim_gtk_blist_node_is_contact_expanded, returns TRUE if the given
1201           blist node is a buddy inside an expanded contact, or is itself an
1202           expanded contact
1203         * GaimLogSet struct, get_log_sets function to GaimLogLogger,
1204           gaim_log_get_log_sets, gaim_log_set_compare
1205         * gaim_privacy_check(), to check if a given user is allowed to send
1206           messages to the specified account
1207         * gtk_imhtml_clear_formatting()
1208         * gtk_imhtml_delete to clear out part of a imhtml buffer
1209         * gtk_imhtml_get_protocol_name()
1210         * gaim_buddy_icons_get_full_path(), to get the full path of a buddy
1211           icon setting
1212         * CHAT_USERS_ALIAS_COLUMN, CHAT_USERS_COLOR_COLUMN,
1213           CHAT_USERS_BUDDY_COLUMN to the list of columns for the chat
1214           user list
1215         * gaim_account_add_buddy()
1216         * gaim_account_add_buddies()
1217         * gaim_account_remove_buddy()
1218         * gaim_account_remove_buddies()
1219         * gaim_account_change_password()
1220         * gaim_account_supports_offline_message()
1221         * gaim_conversation_close_logs(), to force a conversation's log(s) to
1222           be closed.  New logs will be opened as necessary.
1223         * gaim_got_protocol_handler_uri()
1224         * gaim_plugin_get_id()
1225         * gaim_plugin_get_name()
1226         * gaim_plugin_get_version()
1227         * gaim_plugin_get_summary()
1228         * gaim_plugin_get_description()
1229         * gaim_plugin_get_author()
1230         * gaim_plugin_get_homepage()
1231         * gaim_gtkconv_switch_active_conversation(GaimConversation *)
1232         * gaim_str_strip_char() to strip a given character from
1233           a given string
1234         * gaim_util_chrreplace() to replace a given character with a
1235           different character
1236         * gaim_gtk_blist_toggle_visibility() to intelligently toggle the
1237           visiblity of the buddy list
1238         * gaim_gtk_blist_visibility_manager_add() to indicate the addition of a
1239           visibility manager - see the docs for more information
1240         * gaim_gtk_blist_visibility_manager_remove() to indicate the removal of
1241           a visibility manager - see the docs for more information
1242         * gaim_gtk_conversations_find_unseen_list() to get a list of conversations
1243           with an "unseen" state >= to the specified state and other criteria
1244         * gaim_gtk_conversations_fill_menu() fill a menu from list of conversations
1245         * gaim_gtk_create_prpl_icon()
1246         * gaim_gtk_create_prpl_icon_with_status()
1247         * gaim_gtk_pounces_manager_show()
1248         * gaim_gtk_pounces_manager_hide()
1249         * gaim_gtk_pounce_editor_show()
1250         * GAIM_POUNCE_MESSAGE_RECEIVED
1251         * GaimPounceOption
1252         * gaim_pounce_set_options()
1253         * gaim_pounce_set_options()
1254         * GAIM_STOCK_CONNECT, GAIM_STOCK_DISCONNECT
1255         * GAIM_STOCK_PLUGIN
1256         * gaim_account_request_add: Notifies the user that they were added to
1257                                     someone's buddy list, and offers them the choice
1258                                     of adding that person to their buddy list.
1259         * gaim_blist_alias_contact()
1260         * gaim_cipher_http_digest_calculate_session_key()
1261         * gaim_cipher_http_digest_calculate_response()
1262         * gaim_notify_searchresults_labeled()
1263         * GAIM_NOTIFY_BUTTON_LABELED, GAIM_NOTIFY_BUTTON_INFO,
1264           GAIM_NOTIFY_BUTTON_IM, GAIM_NOTIFY_BUTTON_JOIN,
1265           GAIM_NOTIFY_BUTTON_INVITE
1266         * stock buttons GAIM_STOCK_IM, GAIM_STOCK_INFO
1267         * gaim_conversation_present()
1268         * GaimConversationUiOps->present(GaimConversation *)
1269         * GaimPlugin.unloadable
1270         * gaim_plugin_is_unloadable()
1271         * GAIM_PLUGIN_PREF_STRING_FORMAT
1272         * gaim_plugin_pref_get_format_type()
1273         * gaim_plugin_pref_set_format_type()
1274         * GaimStringFormatType
1275         * gaim_log_get_handle()
1276         * gaim_log_uninit()
1277         * GAIM_SUBTYPE_LOG
1278         * gaim_marshal_POINTER__POINTER_POINTER
1279         * gaim_utf8_ncr_encode()
1280         * gaim_gtk_log_init()
1281         * gaim_gtk_log_get_handle()
1282         * gaim_gtk_log_uninit()
1283         * gaim_util_fetch_url_request()
1284         * GaimMenuAction
1285         * gaim_menu_action_new()
1286         * gaim_menu_action_free()
1287         * GaimInfoFieldFormatCallback
1288         * gaim_utf8_strftime()
1289         * gaim_date_format_short()
1290         * gaim_date_format_long()
1291         * gaim_date_format_full()
1292         * gaim_time_format()
1293         * gaim_plugin_action_free()
1294         * GaimRequestType: Added GAIM_REQUEST_FOLDER
1295         * GaimRequestUiOps: Added request_folder
1296         * gaim_request_folder()
1297         * gaim_gtk_setup_screenname_autocomplete()
1298         * gaim_gtk_set_cursor()
1299         * gaim_gtk_clear_cursor()
1300         * GAIM_MESSAGE_ACTIVE_ONLY
1301         * gaim_proxy_get_setup()
1302         * GaimNotifySearchResultsCallback: Added user_data.
1303         * gaim_notify_searchresults: Added user_data.
1304         * gaim_network_listen_cancel(): Can be used to cancel a previous
1305           call to gaim_network_listen() or gaim_network_listen_range()
1306         * gaim_proxy_connect_cancel(): Can be used to cancel a pending
1307           gaim_proxy_connect() request
1308         * gaim_proxy_connect_cancel_with_handle(): Can be used to cancel
1309           a previous gaim_proxy_connect() request using a specified handle
1310         * gaim_dnsquery_destroy(): Can be used to cancel a pending DNS
1311           query.
1312         * gaim_util_fetch_url_cancel(): Can be used to cancel a pending
1313           call to gaim_util_fetch_url() or gaim_util_fetch_url_request().
1314         * GaimGtkWindow: dialogs.search (previously in GaimGtkConversation)
1315         * gaim_buddy_get_server_alias()
1316         * gaim_conv_send_confirm()
1317         * GaimConversationUiOps.send_confirm
1318         * gaim_gtk_roomlist_dialog_show_with_account
1319         * gaim_gtk_tree_view_search_equal_func to be used with
1320           gtk_tree_view_set_search_equal_func
1321         * gaim_xfer_set_bytes_sent().  Sets the offset in the file to
1322           read from or write to.
1323         * gaim_privacy_deny and gaim_privacy_allow
1324         * gaim_gtk_blist_set_headline
1325         * gaim_gtk_set_urgent
1326         * GtkGaimScrollBook and its functions.
1327         * purple_markup_unescape_entity()
1328         * purple_markup_get_css_property()
1329         * purple_group_get_name()
1330
1331         Signals - Changed:  (See the Doxygen docs for details on all signals.)
1332         * Signal propagation now stops after a handler returns a non-NULL value.
1333           This value is now returned.  Previously, all registered handlers were
1334           called and the value from the last handler was used.
1335         * "buddy-typing" and "buddy-typing-stopped": replaced the GaimConversation*
1336           with GaimAccount*, const char *name.  Also, the signal is now emitted
1337           regardless of whether a conversation exists and regardless of whether
1338           the user is on the buddy list.
1339         * "chat-buddy-joined": added the new_arrival argument
1340         * "chat-invited" handlers can now return a value to control what happens
1341           to the invite (accept, reject, prompt the user).
1342         * "chat-left": Emitted *after* setting chat->left to TRUE.
1343         * "drawing-tooltip": the second argument is now a GString* instead of
1344           a char**
1345         * "drawing-tooltip": added the "full" argument
1346         * "received-im-msg" and "received-chat-msg" to match, both now pass a
1347           conversation pointer and flags
1348         * "receiving-im-msg" and "receving-chat-msg" to match, both now pass a
1349           conversation pointer and a pointer to the flags.
1350         * "writing-im-msg", "wrote-im-msg", "writing-chat-msg", "wrote-chat-msg":
1351           Now emitted from a difference place in the message handling code.
1352           The arguments also changed.
1353         * "displaying-im-msg", "displayed-im-msg", "displaying-chat-msg",
1354           "displayed-chat-msg": Added "who" argument, which changes the order
1355           of the existing arguments.
1356
1357         Signals - Added:  (See the Doxygen docs for details on all signals.)
1358         * "account-disabled"
1359         * "account-status-changed"
1360         * "account-alias-changed"
1361         * "cipher-added"
1362         * "cipher-removed"
1363         * "conversation-dragging"
1364         * "dbus-method-called"
1365         * "dbus-introspect"
1366         * "file-recv-accept"
1367         * "file-recv-start"
1368         * "file-recv-cancel"
1369         * "file-recv-complete"
1370         * "file-recv-request"
1371         * "file-send-accept"
1372         * "file-send-start"
1373         * "file-send-cancel"
1374         * "file-send-complete"
1375         * "buddy-added"
1376         * "buddy-removed"
1377         * "blist-node-aliased"
1378         * "buddy-status-changed"
1379         * "buddy-idle-changed": A buddy's idle status changed.
1380         * "buddy-icon-changed"
1381         * "buddy-got-login-time": The login time for a buddy is now known
1382         * "displaying-userinfo"
1383         * "gtkblist-hiding"
1384         * "gtkblist-unhiding"
1385         * "log-displaying"
1386         * "network-configuration-changed"
1387         * "savedstatus-changed"
1388         * "sendto-extended-menu"
1389         * "uri-handler"
1390
1391         Signals - Removed:
1392         * "account-away": replaced by account-status-changed
1393         * "account-warned"
1394         * "buddy-away": replaced by buddy-status-changed
1395         * "buddy-back": replaced by buddy-status-changed
1396         * "buddy-idle": replaced by buddy-idle-changed
1397         * "buddy-unidle": replaced by buddy-idle-changed
1398         * "buddy-icon-cached": replaced by buddy-icon-changed
1399         * "conversation-drag-end": replaced by conversation-dragging
1400         * "conversation-switching"
1401
1402 version 1.5.0 (8/11/2005):
1403         * Added: gaim_xfer_conversation_write
1404           Writes a messages to a conversation window with the use
1405           of the associated file transfer.
1406
1407 version 1.4.0 (7/7/2005):
1408         * Added: gaim_buddy_icon_uncache()
1409           Deletes a cached buddy icon for a specified buddy
1410         * Added: gaim_buddy_icon_get_type
1411           Attempts to determine the type of a given buddy icon.
1412         * Added: buddy-icon-cached signal
1413           Emitted when a new buddy icon is cached.
1414
1415 version 1.3.1 (6/9/2005):
1416         * No changes
1417
1418 version 1.3.0 (5/10/2005):
1419         * Added: gaim_blist_schedule_save()
1420           This should be used instead of gaim_blist_sync when you
1421           want the blist.xml file to be written to disk.  There
1422           should not be many occasions when you want to do this,
1423           as the functions in the blist API that modify the buddy
1424           list will normally call it for you.
1425         * Added: OPT_PROTO_NO_NORMALIZE_CONV
1426           Tells the conversation API to not normalize screen names
1427           in conversations.  This is used by the Jabber PRPL.
1428
1429 version 1.2.1 (4/3/2005):
1430         * No changes
1431
1432 version 1.2.0 (3/17/2005):
1433         * You can use gaim_signal_connect_priority() and
1434           gaim_signal_connect_priority_vargs() to connect to
1435           Gaim signals with a given priority (Will Gorman)
1436         * Added: gaim_conversation_set_features
1437                  gaim_conversation_get_features
1438           These allow plugins (notable prpls) to change the
1439           formatting capabilities of an existing conversation.
1440           This comes with a new "features" field in
1441           GaimConversation (Christopher O'Brien)
1442         * Added: GAIM_CONNECTION_NO_IMAGES to GaimConectionFlags
1443            (Christopher O'Brien)
1444         * Added: GAIM_CBFLAGS_TYPING to GaimConvChatBuddyFlags
1445            (Christopher O'Brien)
1446         * Added: gaim_account_request_add which takes the same arguments as
1447         *  gaim_account_notify_added but always asks the user if they want to add
1448         *  the buddy to the buddy list
1449         * Added: An accompanying request_add GaimAccountUiOp
1450
1451 version 1.1.4 (2/24/2005):
1452         * No changes
1453
1454 version 1.1.3 (2/17/2005):
1455         * No changes
1456
1457 version 1.1.2 (1/20/2005):
1458         * No changes
1459
1460 version 1.1.1 (12/28/2004):
1461         * No changes
1462
1463 version 1.1.0 (12/02/2004):
1464         * Added: gaim_utf8_salvage
1465         * Added: binary relocation support in prefix.h
1466                  WARNING: If your plugin uses anything inside the
1467                  #ifdef ENABLE_BINRELOC from prefix.h, it won't be
1468                  loadable on a copy of Gaim compiled without binreloc
1469                  support. In particular, watch out for the autoconf-like
1470                  macros, and accidently including them through internal.h,
1471                  which you probably shouldn't be including anyway.
1472
1473 version 1.0.0 (09/17/2004):
1474         * Added: get_chat_name to the GaimPluginProtocolInfo struct
1475         * Changed: gaim_blist_update_buddy_presence(), presence changed to
1476                    type gboolean
1477         * Changed: the versioning scheme, and all the plugin structs
1478
1479 version 0.82 (08/26/2004):
1480         Gaim API:
1481         * Removed: gaim_gtk_get_dispstyle(), gaim_gtk_change_text()
1482         * Removed: multi.h
1483         * Renamed: ui.h to gtkdialogs.h
1484         * Renamed: gtkinternal.h to gtkgaim.h
1485         * Renamed: show_info_dialog to gaim_gtkdialogs_info
1486         * Renamed: show_log_dialog to gaim_gtkdialogs_log
1487         * Renamed: show_warn_dialog to gaim_gtkdialogs_warn
1488         * Renamed: show_im_dialog to gaim_gtkdialogs_im
1489         * Renamed: gaim_gtkdialogs_new_im to gaim_gtkdialogs_im_with_user
1490         * Renamed: destroy_all_dialogs to gaim_gtkdialogs_destroy_all
1491         * Renamed: alias_dialog_bud to gaim_gtkdialogs_alias_buddy
1492         * Renamed: alias_dialog_contact to gaim_gtkdialogs_alias_contact
1493         * Renamed: alias_dialog_blist_chat to gaim_gtkdialogs_alias_chat
1494         * Renamed: show_confirm_del to gaim_gtkdialogs_remove_buddy
1495         * Renamed: show_confirm_del_group to gaim_gtkdialogs_remove_group
1496         * Renamed: show_confirm_del_blist_chat to gaim_gtkdialogs_remove_chat
1497         * Renamed: show_confirm_del_contact to gaim_gtkdialogs_remove_contact
1498         * Renamed: show_about to gaim_gtkdialogs_about
1499         * Added: gaim_notify_userinfo() and the associated notify_userinfo() UI op
1500                  which pass account and contact information associated with the
1501                  userinfo
1502
1503         Buddy List API:
1504         * Changed: gaim_blist_request_add_chat(), added name parameter
1505         * Added: gaim_contact_on_account()
1506         * Added: flags parameter to the GaimBlistNode struct
1507
1508         Conversation API:
1509         * Added: gaim_gtkconv_button_new()
1510
1511         Protocol Plugin API: v7
1512         * Added: chat_info_defaults to the GaimPluginProtocolInfo struct
1513
1514         Signals:
1515         * Added: conversation-updated for any update to the data associated
1516           with the conversation (topic, icon, adding to buddy list, etc.)
1517
1518         Conversation API:
1519         * Changed: gaim_conv_chat_add_user() (added new_arrival parameter)
1520
1521 version 0.81 (08/05/2004):
1522         Commands API:
1523         * Most functions now have a void *data argument.
1524
1525         Blist API:
1526         * Added: gaim_buddy_get_contact_alias
1527         * Renamed: gaim_get_buddy_alias to gaim_buddy_get_alias
1528         * Renamed: gaim_get_buddy_alias_only to gaim_buddy_get_alias_only
1529
1530         Conversation API:
1531         * Changed: gaim_conv_chat_add_user(), added flags parameter
1532         * Changed: gaim_conv_chat_add_users(), added GList of flags parameter
1533         * Changed: gaim_conv_chat_get_users(), now returns a GList of
1534           GaimConvChatBuddy's
1535         * Changed: gaim_conv_chat_set_users() now expects a GList of
1536           GaimConvChatBuddy's
1537         * Added: gaim_conv_chat_set_user_flags()
1538         * Added: gaim_conv_chat_get_user_flags()
1539         * Added: gaim_conv_chat_find_user()
1540         * Added: gaim_conv_chat_cb_new()
1541         * Added: gaim_conv_chat_cb_find()
1542         * Added: gaim_conv_chat_cb_destroy()
1543         * Added: gaim_conv_chat_cb_get_name()
1544
1545         Conversation UI ops:
1546         * Added: chat_update_user()
1547
1548         Signals:
1549         * Changed: chat-buddy-joining & chat-buddy-joined now include the user's flags
1550         * Changed: chat-buddy-joining & chat-buddy-leaving are now booleans, return
1551           TRUE if you don't want the join/leave to be displayed in the UI.
1552         * Added: chat-buddy-flags for when user's flags change
1553           gaim_marshal_VOID__POINTER_POINTER_POINTER_UINT_UINT (required for the new
1554           chat-buddy-flags signal)
1555         * Added: account-modified for when account settings have been changed.
1556
1557 version 0.80 (07/15/2004):
1558         Gaim API:
1559         * Removed: PRPL numbers : gaim_account_set_protocol(),
1560           gaim_account_get_protocol(), gaim_accounts_find_with_prpl_num,
1561           gaim_prpl_num_to_id(), gaim_prpl_id_to_num(), GaimProtocol
1562
1563         Protocol Plugin API: v6
1564         * Added: can_receive_file & send_file to the GaimPluginProtocolInfo struct
1565
1566         Signals:
1567         * Changed "chat-invited" to also include the components hash table so
1568           plugins can use serv_join_chat when the signal is emitted.
1569         * Added "chat-topic-changed" signal plugins know when a topic is changed.
1570
1571 version 0.79 (06/24/2004):
1572         Gaim API:
1573         * gaim_url_parse() now takes two additional parameters, which are used
1574           for returning the username and password from the URL, if they exist.
1575         * Added: has_focus UI op to GaimConversationUiOps and
1576           GaimConvWindowUiOps.
1577         * Added: gaim_conversation_has_focus() and gaim_conv_window_has_focus().
1578         * Removed: gaim_blist_save()
1579
1580         Protocol Plugin API: v5
1581         * Changed: add_buddy, add_buddies, remove_buddy, remove_buddies,
1582           rename_group and remove_group to take GaimBuddy's and
1583           GaimGroup's consistently.
1584         * Removed: OPT_PROTO_BUDDY_ICON (replaced by icon_spec)
1585         * Added: icon_spec to the GaimPluginProtocolInfo struct
1586
1587 version 0.78 (05/30/2004):
1588         Plugin API: v4
1589         * Added: actions - for plugins to add to the new Plugin Actions menu
1590
1591         Loader Plugin API: v2 (no changes)
1592
1593         Protocol Plugin API: v4
1594         * Removed: set_dir, get_dir and dir_search (not used, AIM-centric)
1595         * Removed: actions (replaced by generic plugin actions)
1596
1597         Perl Plugin API: v2 (no changes)
1598         TCL Plugin API: (no changes)
1599
1600         Signals:
1601         * Added: "blist-node-extended-menu" for extending Buddy, Chat and
1602                          Group right-click menus
1603         * Added: "drawing-tooltip" for plugins to allow plugins to change text
1604                          appearing in tooltips
1605         * Added: "gtkblist-created"
1606         * Added: "receiving-im-msg" and "receiving-chat-msg" (these behave
1607                           exactly like received-*-msg used to)
1608         * Added: "buddy-idle-updated" signal, for when the idle time changes.
1609         * Changed: "received-im-msg" and "received-chat-msg" no longer pass
1610                            pointers to who, message and flags, and are now void.
1611         * Removed: "drawing-menu" - it was UI sepecific and
1612                            "blist-node-extended-menu" is superior
1613
1614 version 0.77 (04/22/2004):
1615         Loader & Protocol Plugins independantly versioned
1616         Plugin loading now checks versioning on plugins (Standard, Loader &
1617         Protocol)
1618         new GAIM_{PLUGIN,PRPL,LOADER}_API_VERSION constants
1619
1620         Plugin API: v3
1621         * Added: prefs_info for UI independant plugin prefs
1622
1623         Loader Plugin API: v2
1624         * Added: api_version at top of GaimPluginLoaderInfo struct
1625
1626         Protocol Plugin API: v2
1627         * Added: api_version at top of GaimPluginProtocolInfo struct
1628         * Added: chat_menu for protocol specific extensions to the chat menu
1629         * Removed: get_away "Nada used it. Pink elephants on parade."
1630         * Removed: protocol_prefs (replaced by generic plugin prefs_info)
1631
1632         Perl Plugin API: v2 (no changes)
1633         TCL API: (no changes)
1634
1635         Signals:
1636         * Added: "conversation-drag-ended"
1637
1638 version 0.76 (04/01/2004):
1639         Plugin API: v2
1640         Perl Plugin API: v2
1641         Loader Plugin API: (not versioned)
1642         Protocol Plugin API: (not versioned)
1643         * Added: protocol_prefs for protocol specific preferences
1644         * Added: reject_chat so protocols can act on chat invite rejection
1645
1646         TCL Plugin API: (not versioned)
1647         * Changes to plugin registration to show descriptions
1648