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