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