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