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