Merged in default (pull request #548)
[pidgin-git.git] / ChangeLog.API
blob37e5f5723d6e52ffb52f36c4de6866a768fe118e
1 Pidgin and Finch: The Pimpin' Penguin IM Clients That're Good for the Soul
3 This file intends to list all changes to libpurple, Pidgin, and Finch's public
4 API. We sometimes forget to add changes to this file--sorry.
6 If your plugin fails to build with a new major version (e.g. 3.0.0) we
7 suggest checking this list first, in case a function was simply renamed.
8 You may still need to consult our API docs or our source code.
10 If you notice something missing from this list, please let us know and we'll
11 add it.
13 version 3.0.0 (??/??/????):
14         libpurple:
15                 Added:
16                 * displaying-emails-clear signal (notification signal)
17                 * purple_account_is_disconnecting
18                 * purple_account_get_ui_data
19                 * purple_account_set_ui_data
20                 * purple_account_privacy_get_denied
21                 * purple_account_privacy_get_permitted
22                 * PurpleAccountPresence and PurpleBuddyPresence inherit PurplePresence
23                 * purple_account_presence_new
24                 * purple_buddy_presence_new
25                 * purple_account_register_completed
26                 * purple_blist_get_default_root
27                 * purple_blist_node_is_transient
28                 * purple_blist_node_set_transient
29                 * purple_certificate_get_der_data
30                 * purple_certificate_get_display_string
31                 * purple_chat_user_get_alias
32                 * purple_chat_user_get_chat
33                 * purple_chat_user_get_flags
34                 * purple_chat_user_is_buddy
35                 * purple_chat_user_get_ui_data
36                 * purple_chat_user_set_ui_data
37                 * purple_chat_user_set_chat
38                 * purple_connection_get_active_chats
39                 * purple_connection_get_error_info
40                 * purple_connection_get_flags
41                 * purple_connection_set_flags
42                 * purple_connection_update_last_received
43                 * purple_conversation_get_ui_data
44                 * purple_conversation_set_ui_data
45                 * purple_conversation_message_get_alias
46                 * purple_conversation_message_get_conv
47                 * PurpleCountingNode, inherits PurpleBlistNode
48                 * purple_counting_node_get_*
49                 * purple_counting_node_change_*
50                 * purple_counting_node_set_*
51                 * PurpleIMConversation and PurpleChatConversation inherit
52                   PurpleConversation
53                 * purple_notify_emails_pending
54                 * purple_notify_emails_present
55                 * purple_notify_searchresult_column_get_title
56                 * purple_notify_searchresult_column_is_visible
57                 * purple_notify_searchresult_column_set_visible
58                 * purple_notify_user_info_entry_destroy
59                 * purple_notify_user_info_prepend_pair_plaintext
60                 * purple_media_manager_enumerate_elements
61                 * purple_menu_action_get_callback
62                 * purple_menu_action_get_children
63                 * purple_menu_action_get_data
64                 * purple_menu_action_set_label
65                 * purple_menu_action_set_data
66                 * purple_menu_action_set_callback
67                 * purple_menu_action_set_children
68                 * PurplePluginInfoFlags (PURPLE_PLUGIN_INFO_FLAGS_INTERNAL and
69                   PURPLE_PLUGIN_INFO_FLAGS_AUTO_LOAD)
70                 * purple_plugin_get_dependent_plugins
71                 * purple_plugin_get_filename
72                 * purple_plugin_is_internal
73                 * purple_plugin_info_new
74                 * purple_plugin_get_info
75                 * purple_plugin_info_get_abi_version
76                 * purple_plugin_info_get_actions_cb
77                 * purple_plugin_info_get_category
78                 * purple_plugin_info_get_dependencies
79                 * purple_plugin_info_get_error
80                 * purple_plugin_info_get_extra_cb
81                 * purple_plugin_info_get_flags
82                 * purple_plugin_info_get_icon
83                 * purple_plugin_info_get_license_id
84                 * purple_plugin_info_get_license_text
85                 * purple_plugin_info_get_license_url
86                 * purple_plugin_info_get_pref_frame_cb
87                 * purple_plugin_info_get_pref_request_cb
88                 * purple_plugin_info_get_ui_data
89                 * purple_plugin_info_set_ui_data
90                 * purple_plugin_register_type
91                 * purple_plugin_add_interface
92                 * PURPLE_DEFINE_TYPE
93                 * PURPLE_DEFINE_TYPE_EXTENDED
94                 * PURPLE_IMPLEMENT_INTERFACE_STATIC
95                 * PURPLE_IMPLEMENT_INTERFACE
96                 * PURPLE_DEFINE_DYNAMIC_TYPE
97                 * PURPLE_DEFINE_DYNAMIC_TYPE_EXTENDED
98                 * PURPLE_IMPLEMENT_INTERFACE_DYNAMIC
99                 * PURPLE_DEFINE_STATIC_TYPE
100                 * PURPLE_DEFINE_STATIC_TYPE_EXTENDED
101                 * PurpleProtocol, inherits GObject. Please see the documentation for
102                   details.
103                 * PurpleProtocolAction
104                 * PurpleProtocolOverrideFlags
105                 * PurpleProtocolClientIface
106                 * PurpleProtocolServerIface
107                 * PurpleProtocolIMIface
108                 * PurpleProtocolChatIface
109                 * PurpleProtocolPrivacyIface
110                 * PurpleProtocolXferIface
111                 * PurpleProtocolRoomlistIface
112                 * PurpleProtocolAttentionIface
113                 * PurpleProtocolMediaIface
114                 * PurpleProtocolFactoryIface
115                 * purple_protocol_get_* for PurpleProtocol members
116                 * purple_protocol_class_* for class methods
117                 * purple_protocol_server_iface_* for server interface methods
118                 * purple_protocol_im_iface_* for IM interface methods
119                 * purple_protocol_privacy_iface_* for privacy interface methods
120                 * purple_protocol_xfer_iface_* for xfer interface methods
121                 * purple_protocol_attention_iface_* for attention interface methods
122                 * purple_protocol_factory_iface_* for factory interface methods
123                 * purple_protocol_action_new
124                 * purple_protocol_action_free
125                 * purple_protocols_add
126                 * purple_protocols_remove
127                 * purple_protocols_find
128                 * purple_protocols_get_all
129                 * purple_protocols_get_handle
130                 * purple_protocols_init
131                 * purple_protocols_uninit
132                 * purple_request_certificate
133                 * purple_request_field_certificate_new
134                 * purple_request_field_certificate_get_value
135                 * purple_request_field_get_tooltip
136                 * purple_request_field_group_get_fields_list
137                 * purple_request_field_set_tooltip
138                 * purple_request_fields_get_ui_data
139                 * purple_request_fields_set_ui_data
140                 * purple_roomlist_get_account
141                 * purple_roomlist_get_proto_data
142                 * purple_roomlist_get_ui_data
143                 * purple_roomlist_room_get_expanded_once
144                 * purple_roomlist_room_set_expanded_once
145                 * purple_roomlist_set_proto_data
146                 * purple_roomlist_set_ui_data
147                 * purple_whiteboard_get_account
148                 * purple_whiteboard_get_draw_list
149                 * purple_whiteboard_set_draw_list
150                 * purple_whiteboard_get_protocol_data
151                 * purple_whiteboard_set_protocol_data
152                 * purple_whiteboard_get_state
153                 * purple_whiteboard_set_state
154                 * purple_whiteboard_get_ui_data
155                 * purple_whiteboard_set_ui_data
156                 * purple_whiteboard_get_who
157                 * purple_xfer_get_fd
158                 * purple_xfer_get_message
159                 * purple_xfer_get_protocol_data
160                 * purple_xfer_get_ui_data
161                 * purple_xfer_get_watcher
162                 * purple_xfer_set_fd
163                 * purple_xfer_set_local_port
164                 * purple_xfer_set_protocol_data
165                 * purple_xfer_set_remote_user
166                 * purple_xfer_set_status
167                 * purple_xfer_set_ui_data
168                 * purple_xfer_set_watcher
169                 * purple_xmlnode_get_default_namespace
170                 * purple_xmlnode_strip_prefixes
172                 Changed:
173                 * account.h has been split into account.h (PurpleAccount GObject) and
174                   accounts.h (Accounts subsystem)
175                 * blist.h has been split into buddylist.h (PurpleBuddyList and
176                   subsystem), blistnode.h (PurpleBlistNode and PurpleCountingNode
177                   GObjects), blistnodetypes (Buddy, Chat, Contact, Group GObjects)
178                 * circbuffer.h renamed to circularbuffer.h
179                 * conversation.h has been split into conversation.h
180                   (PurpleConversation), conversationtypes.h (PurpleIMConversation and
181                   PurpleChatConversation) and conversations.h (Conversations subsystem)
182                 * Renamed ft.h file to xfer.h
183                 * Renamed plugin.h file to plugins.h
184                 * prpl.h has been split into protocol.h (PurpleProtocol GObject and
185                   protocol interfaces) and protocols.h (protocols subsystem)
186                 * status.h has been split into status.h (Status API) and presence.h
187                   (Presence API)
188                 * account-authorization-requested signal merged with
189                   account-authorization-requested-with-message signal
190                 * purple_account_add_buddy now takes an invite message as the last
191                   parameter
192                 * purple_account_add_buddies now takes an invite message as the last
193                   parameter
194                 * PurpleAccount is now a GObject. Please see the documentation for
195                   details.
196                 * purple_account_get_alias renamed to purple_account_get_private_alias
197                 * purple_account_set_alias renamed to purple_account_set_private_alias
198                 * purple_account_option_get_type renamed to
199                   purple_account_option_get_pref_type
200                 * PurplePrivacyType renamed to PurpleAccountPrivacyType
201                 * purple_privacy_* functions are now purple_account_privacy_*
202                 * Removed arguments local and restore from purple_account_privacy_allow
203                   and purple_account_privacy_deny
204                 * PurpleBlistNode is now a GObject. Please see the documentation for
205                   details.
206                 * purple_blist_alias_buddy renamed to purple_buddy_set_local_alias
207                 * purple_blist_alias_chat renamed to purple_chat_set_alias
208                 * purple_blist_alias_contact renamed to purple_contact_set_alias
209                 * purple_blist_get_root now takes a PurpleBuddyList parameter;
210                   use purple_blist_get_default_root to work on the default buddy
211                   list as before
212                 * purple_blist_merge_contact renamed to purple_contact_merge
213                 * purple_blist_rename_buddy renamed to purple_buddy_set_name
214                 * purple_blist_rename_group renamed to purple_group_set_name
215                 * purple_blist_server_alias_buddy renamed to
216                 * purple_blist_update_buddy_status renamed to purple_buddy_update_status
217                   purple_buddy_set_server_alias
218                 * purple_buddy_get_local_buddy_alias renamed to
219                   purple_buddy_get_local_alias
220                 * PurpleContact and PurpleGroup inherit PurpleCountingNode
221                 * PurpleBuddyList is now a GObject. Please see the documentation for
222                   details.
223                 * purple_find_buddies renamed to purple_blist_find_buddies
224                 * purple_find_buddy_in_group renamed to purple_blist_find_buddy_in_group
225                 * purple_find_buddy renamed to purple_blist_find_buddy
226                 * purple_find_group renamed to purple_blist_find_group
227                 * purple_get_blist renamed to purple_blist_get_default
228                 * PurpleBuddyIconSpec has been moved to buddyicon.h
229                 * purple_certificate_check_signature_chain now returns a list of failing
230                   PurpleCertificate*s as the second parameter
231                 * PurpleConversation is now an abstract type, and is a GObject. Please
232                   see the documentation for details.
233                 * purple_conv_* functions are now purple_conversation_*
234                 * purple_conv_im_* functions are now purple_im_conversation_*
235                 * purple_conv_chat_* functions are now purple_chat_conversation_*
236                 * purple_chat_conversation_find_user renamed to
237                   purple_chat_conversation_has_user
238                 * PurpleTypingState renamed to PurpleIMTypingState
239                 * PurpleConvChatBuddy changed to PurpleChatUser, is now a GObject.
240                   Please see the documentation for details.
241                 * purple_conv_chat_cb_* functions are now purple_chat_user_*
242                 * Replaced 'chat-buddy' with 'chat-user' in conversation signals
243                 * Replaced chatname, buddyname arguments of 'chat-user-flags' (formerly
244                   'chat-buddy-flags') signal with PurpleChatUser *
245                 * PurpleCircBuffer changed to PurpleCircularBuffer, is now a GObject.
246                   Please see the documentation for details.
247                 * purple_circ_buffer_* functions are now purple_circular_buffer_*
248                 * purple_connection_error now takes a PurpleConnectionError
249                   as the second parameter
250                 * PurpleConnection is now a GObject. Please see the documentation for
251                   details.
252                 * PURPLE_CONNECTION_* prefix of PurpleConnectionFlag enum names changed
253                   to PURPLE_CONNECTION_FLAG_*
254                 * PURPLE_* prefix of PurpleConnectionState enum names changed to
255                   PURPLE_CONNECTION_*
256                 * purple_conversation_get_gc renamed to
257                   purple_conversation_get_connection
258                 * purple_dnsquery_a now takes a PurpleAccount as the first parameter
259                 * PurpleIconScaleRules renamed to PurpleBuddyIconScaleFlags
260                 * purple_imgstore_add renamed to purple_imgstore_new
261                 * purple_imgstore_add_with_id renamed to purple_imgstore_new_with_id
262                 * PurpleLog, purple_log_new, purple_log_write and
263                   PurpleLogLogger->write take a GDateTime instead of a time_t
264                   and struct tm
265                 * purple_network_listen now takes the protocol family as the second
266                   parameter
267                 * purple_network_listen now takes a boolean indicating external port
268                   mapping as the fourth parameter
269                 * purple_network_listen_range now takes a boolean indicating external
270                   port mapping as the fifth parameter
271                 * purple_network_listen_range now takes the protocol family as the
272                   third parameter
273                 * PurpleNotifyMsgType renamed to PurpleNotifyMessageType
274                 * purple_notify_user_info_add_pair renamed to
275                   purple_notify_user_info_add_pair_html
276                 * purple_notify_user_info_get_entries returns a GQueue instead of
277                   a GList
278                 * purple_notify_user_info_entry_get_type renamed to
279                   purple_notify_user_info_entry_get_entry_type
280                 * purple_notify_user_info_entry_set_type renamed to
281                   purple_notify_user_info_entry_set_entry_type
282                 * purple_notify_user_info_prepend_pair renamed to
283                   purple_notify_user_info_prepend_pair_html
284                 * PurplePlugin is now a GObject (alias for GPluginPlugin). Please see
285                   the documentation for details.
286                 * PurplePluginInfo is now a GObject, inherits GPluginPluginInfo. Please
287                   see the documentation for details.
288                 * PurplePluginAction no longer has a context field. Use
289                   PurpleProtocolAction for protocol actions.
290                 * PURPLE_INIT_PLUGIN(pluginname, initfunc, plugininfo) is now
291                   PURPLE_PLUGIN_INIT(pluginname, query_func, load_func, unload_func).
292                   See "C Plugins tutorial" (tut_c_plugins.xml) for an example.
293                 * purple_plugin_load and purple_plugin_unload now use an error argument
294                   to return load/unload errors
295                 * purple_plugins_get_all is now purple_plugins_find_all, and the
296                   returned list of plugins MUST be free'd using g_list_free
297                 * purple_plugin_get_* functions for plugin info are now
298                   purple_plugin_info_get_*
299                 * purple_plugin_get_author is now purple_plugin_info_get_authors, and
300                   returns a NULL-terminated list of authors
301                 * purple_plugins_probe is now purple_plugins_refresh
302                 * purple_plugins_find_with_id renamed to purple_plugins_find_plugin
303                 * purple_plugins_find_with_filename renamed to
304                   purple_plugins_find_by_filename
305                 * purple_plugin_pref_get_type renamed to
306                   purple_plugin_pref_get_pref_type
307                 * purple_plugin_pref_set_type renamed to
308                   purple_plugin_pref_set_pref_type
309                 * purple_prefs_get_type renamed to purple_prefs_get_pref_type
310                 * proto_chat_entry has been renamed to PurpleProtocolChatEntry
311                 * purple_proxy_info_get_type renamed to purple_proxy_info_get_proxy_type
312                 * purple_proxy_info_set_type renamed to purple_proxy_info_set_proxy_type
313                 * purple_request_field_get_type renamed to
314                   purple_request_field_get_field_type
315                 * PurpleRoomlist is now a GObject. Please see the documentation for
316                   details.
317                 * purple_roomlist_room_get_type is now
318                   purple_roomlist_room_get_room_type
319                 * purple_roomlist_field_get_type is now
320                   purple_roomlist_field_get_field_type
321                 * purple_savedstatus_get_type renamed to
322                   purple_savedstatus_get_primitive_type
323                 * purple_savedstatus_set_type renamed to
324                   purple_savedstatus_set_primitive_type
325                 * purple_savedstatus_substatus_get_type renamed to
326                   purple_savedstatus_substatus_get_status_type
327                 * serv_* functions are now purple_serv_*
328                 * purple_srv_resolve now takes a PurpleAccount as the first parameter
329                 * purple_srv_txt_query_get_type renamed to
330                   purple_srv_txt_query_get_query_type
331                 * PurpleStatus is now a GObject. Please see the documentation for
332                   details.
333                 * purple_status_attr_* functions are now purple_status_attribute_*
334                 * PurpleStatusAttr renamed to PurpleStatusAttribute
335                 * PurplePresence is now an abstract type, and is a GObject. Please see
336                   the documentation for details.
337                 * update_idle method has been added to PurplePresenceClass to update the
338                   idle state of a presence
339                 * StunCallback renamed to PurpleStunCallback
340                 * purple_str_size_to_units now takes a goffset as the size parameter
341                 * PTFunc renamed to PurpleThemeFunc
342                 * purple_txt_resolve now takes a PurpleAccount as the first parameter
343                 * UPnPMappingAddRemove renamed to PurpleUPnPMappingAddRemove
344                 * purple_util_fetch_url_request now takes a PurpleAccount as
345                   the first parameter
346                 * purple_util_fetch_url_request now takes a length as the eighth
347                   parameter
348                 * purple_util_fetch_url_len now takes a length as the fifth parameter
349                 * PurpleWhiteboard is now a GObject. Please see the documentation for
350                   details.
351                 * purple_value_destroy is now purple_value_free
352                 * purple_value_new, purple_value_dup and purple_value_free now operate
353                   on GValue instead of PurpleValue
354                 * Signal registration now uses GTypes instead of PurpleValues.  See
355                   SIGNAL-HOWTO for more information.
356                 * purple_whiteboard_create renamed to purple_whiteboard_new
357                 * purple_xfer_get_bytes_remaining now returns a goffset
358                 * purple_xfer_get_bytes_sent now returns a goffset
359                 * purple_xfer_get_size now returns a goffset
360                 * purple_xfer_is_canceled renamed to purple_xfer_is_cancelled
361                 * PurpleXfer is now a GObject. Please see the documentation for details.
362                 * purple_xfer_get_type renamed to purple_xfer_get_xfer_type
363                 * PurpleXferStatusType renamed to PurpleXferStatus
364                 * PURPLE_XFER_* prefix of PurpleXferType enums changed to
365                   PURPLE_XFER_TYPE_*
366                 * purple_xfer_set_bytes_sent now takes a goffset as the bytes_sent
367                   parameter
368                 * purple_xfer_set_size now takes a goffset as the size parameter
369                 * PurpleCertificateVerificationStatus enumeration is now merged with
370                   internal flags, thus removing PURPLE_CERTIFICATE_INVALID and
371                   replacing it with more precise errors.
372                 * PurpleConnectionUiOps.report_disconnect now passes a
373                   PurpleConnectionError as the second parameter
374                 * PurpleXfer.bytes_remaining is now a goffset
375                 * PurpleXfer.bytes_sent is now a goffset
376                 * PurpleXfer.size is now a goffset
377                 * PurpleCertificateScheme.get_times now uses gint64 instead of
378                   time_t to represent times
379                 * purple_certificate_get_times now uses gint64 instead of
380                   time_t to represent times
381                 * xmlnode renamed to PurpleXmlNode
382                 * XMLNodeType renamed to PurpleXmlNodeType
383                 * xmlnode_* functions are now purple_xmlnode_*
385                 Removed:
386                 * buddy-added and buddy-removed blist signals
387                 * privacy.h file
388                 * value.h file
389                 * _PurpleCmdFlag
390                 * _PurpleCmdPriority
391                 * _PurpleCmdRet
392                 * _PurpleCmdStatus
393                 * _PurplePrefType
394                 * _PurplePrivacyType
395                 * _PurpleSoundEventID
396                 * _XMLNodeType
397                 * account-authorization-requested-with-message signal
398                 * network-configuration-changed signal
399                 * PurpleAccoun->ui_data
400                 * purple_account_add_buddies_with_invite
401                 * purple_account_add_buddy_with_invite
402                 * purple_account_get_ui_data
403                 * purple_account_set_current_error
404                 * purple_account_set_ui_data
405                 * purple_base64_*. Use g_base64_* instead
406                 * purple_blist_get_ui_data
407                 * purple_blist_load
408                 * purple_blist_new
409                 * purple_blist_set_ui_data
410                 * purple_set_blist
411                 * purple_blist_update_buddy_icon
412                 * purple_buddy_get_local_alias
413                 * purple_buddy_icons_has_custom_icon
414                 * purple_buddy_icons_find_custom_icon
415                 * purple_buddy_icons_set_custom_icon
416                 * purple_certificate_check_signature_chain_with_failing. Use
417                   purple_certificate_check_signature_chain, instead
418                 * purple_certificate_display_x509. Use purple_request_certificate,
419                   instead
420                 * Purple Cipher API (PurpleCipherContext and friends).
421                   Use GLib's GHmac or GChecksum instead.
422                 * purple_connection_error_reason
423                 * purple_connection_new
424                 * purple_connection_new_unregister
425                 * purple_connection_destroy
426                 * purple_connection_set_account
427                 * purple_contact_set_alias
428                 * purple_conv_chat_set_users
429                 * PurpleConversationType
430                 * purple_core_ensure_single_instance. Check via GApplication
431                   or whatever is appropriate for your UI.
432                 * purple_core_migrate
433                 * Removed the general Purple DBus interface
434                 * purple_dnsquery_a_account
435                 * purple_event_loop_{get|set}_ui_ops. Manually drive the GLib
436                   event loop yourself. See GLib Main Event Loop docs.
437                 * PurpleEventLoopUiOps. Manually drive the GLib event loop
438                   yourself. See GLib Main Event Loop docs.
439                 * purple_get_tzoff_str(). Use g_date_time_format, instead.
440                 * PurpleMimeDocument, PurpleMimePart,
441                   purple_mime_document_new, purple_mime_document_free,
442                   purple_mime_document_parse, purple_mime_document_parsen,
443                   purple_mime_document_write, purple_mime_document_get_fields,
444                   purple_mime_document_get_field,
445                   purple_mime_document_set_field,
446                   purple_mime_document_get_parts, purple_mime_part_new,
447                   purple_mime_part_get_fields, purple_mime_part_get_field,
448                   purple_mime_part_get_field_decoded,
449                   purple_mime_part_set_field, purple_mime_part_get_data,
450                   purple_mime_part_get_data_decoded,
451                   purple_mime_part_get_length, purple_mime_part_set_data, and
452                   purple_mime_decode_field. Use the GMime library, instead.
453                 * purple_network_convert_idn_to_ascii. Use g_hostname_to_ascii,
454                   instead.
455                 * purple_network_listen_family. Use purple_network_listen, instead.
456                 * purple_network_listen_map_external
457                 * purple_network_listen_range_family. Use purple_network_listen,
458                   instead.
459                 * purple_network_ip_atoi
460                 * purple_notify_searchresults_column_get_title
461                 * purple_notify_searchresults_get_columns_count
462                 * purple_notify_searchresults_get_rows_count
463                 * purple_notify_searchresults_row_get
464                 * purple_ntlm_*
465                 * PurplePluginType
466                 * PurplePluginPriority
467                 * PurplePluginLoaderInfo
468                 * PurplePluginUiInfo
469                 * purple_plugin_ipc_*
470                 * purple_plugin_is_unloadable
471                 * purple_plugin_new
472                 * purple_plugin_probe
473                 * purple_plugin_register
474                 * purple_plugin_reload
475                 * purple_plugins_destroy_all
476                 * purple_plugins_enabled
477                 * purple_plugins_find_with_basename
478                 * purple_plugins_find_with_name
479                 * purple_plugins_get_protocols
480                 * purple_plugins_get_search_paths
481                 * purple_plugins_register_load_notify_cb
482                 * purple_plugins_register_probe_notify_cb
483                 * purple_plugins_register_unload_notify_cb
484                 * purple_plugins_unregister_load_notify_cb
485                 * purple_plugins_unregister_probe_notify_cb
486                 * purple_plugins_unregister_unload_notify_cb
487                 * purple_plugins_unload
488                 * purple_plugins_unload_all
489                 * purple_pounces_load
490                 * purple_prefs_set_generic
491                 * purple_prefs_update_old
492                 * purple_presence_add_status
493                 * purple_presence_add_list
494                 * PurplePresenceContext
495                 * purple_presence_new
496                 * purple_presence_new_for_account
497                 * purple_presence_new_for_buddy
498                 * purple_print_utf8_to_console
499                 * PurplePluginProtocolInfo
500                 * purple_proxy_connect_socks5
501                 * purple_quotedp_decode. See the GMime library if needed.
502                 * purple_request_field_list_add
503                 * purple_srv_cancel
504                 * purple_srv_resolve_account
505                 * purple_ssl_connect_fd
506                 * purple_status_set_attr_boolean
507                 * purple_status_set_attr_int
508                 * purple_status_set_attr_string
509                 * purple_status_type_add_attr
510                 * purple_status_type_add_attrs
511                 * purple_status_type_add_attrs_vargs
512                 * purple_status_type_get_primary_attr
513                 * purple_status_type_set_primary_attr
514                 * purple_strlcat
515                 * purple_strlcpy
516                 * purple_timeout_*. Use g_timeout_* or g_idle_* instead.
517                 * purple_txt_cancel
518                 * purple_txt_resolve_account
519                 * PurpleType, use GType instead.
520                 * purple_util_fetch_url_len. Use purple_util_fetch_url, instead.
521                 * purple_util_fetch_url_request_len. Use
522                 * purple_util_fetch_url_request, instead.
523                 * purple_util_fetch_url_request_len_with_account.  Use
524                   purple_util_fetch_url_request, instead.
525                 * purple_util_get_image_checksum.  Use
526                   g_compute_checksum_for_data(G_CHECKSUM_SHA1, ...), instead.
527                 * PurpleCertificateVerificationStatus.PURPLE_CERTIFICATE_INVALID
528                 * PurpleConnectionUiOps.report_disconnect_reason
529                 * PurplePluginProtocolInfo.add_buddy_with_invite
530                 * PurplePluginProtocolInfo.add_buddies_with_invite
531                 * PurplePluginProtocolInfo.get_cb_away
532                 * PurpleValue, use GValue instead.
533                 * serv_got_attention
534                 * serv_send_attention
535                 * struct _PurpleAttentionType
536                 * struct _PurpleCipherCaps
537                 * struct _PurpleConversation
538                 * struct _PurpleConvChat
539                 * struct _PurpleConvChatBuddy
540                 * struct _PurpleConvIm
541                 * struct _PurpleConvMessage
542                 * struct _PurpleMenuAction
543                 * struct _PurplePounce
544                 * struct _PurpleProxyInfo
545                 * struct _PurpleRequestField
546                 * struct _PurpleRoomlist
547                 * struct _PurpleRoomlistField
548                 * struct _PurpleRoomlistRoom
549                 * struct _PurpleWhiteboard
550                 * struct PurpleAccountOption
551                 * struct PurpleAccountUserSplit
552                 * struct PurpleNotifySearchColumn
553                 * wpurple_g_access
554                 * xmlnode_set_attrib_with_namespace
555                 * xmlnode_set_attrib_with_prefix
557                 Deprecated:
558                 * purple_user_dir
559                 * purple_util_write_data_to_file
560                 * purple_util_read_xml_from_file
562         Pidgin:
563                 Added:
564                 * pidgin_create_webview
565                 * PidginDockletFlag
566                 * pidgin_gdk_pixbuf_new_from_image
567                 * PidginPluginInfo, inherits PurplePluginInfo
568                 * Various WebKit-related functions in gtkwebview.h
570                 Changed:
571                 * gtkft.h file renamed to gtkxfer.h
572                 * pidgin_blist_sort_method renamed to _PidginBlistSortMethod
573                 * BRUSH_STATE_DOWN renamed to PIDGIN_BRUSH_STATE_DOWN
574                 * BRUSH_STATE_MOTION renamed to PIDGIN_BRUSH_STATE_MOTION
575                 * BRUSH_STATE_UP renamed to PIDGIN_BRUSH_STATE_UP
576                 * DEFAULT_FONT_FACE renamed to PIDGIN_DEFAULT_FONT_FACE
577                 * DndHintPosition renamed to PidginDndHintPosition
578                 * DndHintWindowId renamed to PidginDndHintWindowId
579                 * dnd_* functions renamed to pidgin_dnd_*
580                 * FULL_CIRCLE_DEGREES renamed to PIDGIN_FULL_CIRCLE_DEGREES
581                 * NUM_NICK_SEED_COLORS renamed to PIDGIN_NUM_NICK_SEED_COLORS
582                 * PALETTE_NUM_COLORS renamed to PIDGIN_PALETTE_NUM_COLORS
583                 * pidgin_account_option_menu_* renamed to
584                   pidgin_account_chooser_*
585                 * pidgin_new_item_from_stock renamed to pidgin_new_menu_item and
586                   removed the accel related parameters.
587                 * pidgin_setup_screenname_autocomplete now takes a filter function and
588                   its data as final two arguments
589                 * smiley_list renamed to PidginSmileyList
590                 * smiley_parse_markup renamed to pidgin_smiley_parse_markup
591                 * smiley_theme renamed to PidginSmileyTheme
592                 * PidginWindow renamed to PidginConvWindow
594                 Removed:
595                 * GtkIMHtml.clipboard_html_string
596                 * GtkIMHtml.clipboard_text_string
597                 * GtkIMHtmlFontDetail
598                 * gtk_imhtml_animation_free
599                 * gtk_imhtml_animation_new
600                 * gtk_imhtml_image_add_to
601                 * gtk_imhtml_image_free
602                 * gtk_imhtml_image_new
603                 * gtk_imhtml_image_scale
604                 * pidgin_blist_update_account_error_state
605                 * PidginBuddyList.connection_errors
606                 * pidgin_check_if_dir
607                 * PidginConversation.sg
608                 * PIDGIN_DIALOG
609                 * pidgin_dialogs_alias_contact
610                 * pidgin_make_pretty_arrows
611                 * pidgin_mini_dialog_links_supported
612                 * pidgin_set_custom_buddy_icon
613                 * pidgin_setup_screenname_autocomplete_with_filter
614                 * pidgin_toggle_sensitive, pidgin_toggle_sensitive_array, and
615                 pidgin_toggle_showhide; use g_object_bind_property instead
616                 * struct _GtkIMHtmlAnimation
617                 * struct _GtkIMHtmlFontDetail
618                 * struct _GtkIMHtmlHr
619                 * struct _GtkIMHtmlImage
620                 * struct _GtkIMHtmlScalable
621                 * struct _GtkSmileyTree
622                 * struct _PidginChatPane
623                 * struct _PidginImPane
625         Finch:
626                 Added:
627                 * FinchPluginInfo, inherits PurplePluginInfo
629                 Changed:
630                 * gntft.h file renamed to gntxfer.h
631                 * gnt_append_menu_action renamed to finch_append_menu_action
632                 * gnt_ui_init renamed to finch_ui_init
633                 * gnt_ui_uninit renamed to finch_ui_uninit
635         libgnt:
636                 Changed:
637                 * ENTRY_CHAR renamed to GNT_ENTRY_CHAR
638                 * g_hash_table_duplicate renamed to gnt_hash_table_duplicate
639                 * GDupFunc renamed to GntDuplicateFunc
641                 Removed:
642                 * _GntFileType
643                 * _GntKeyPressMode
644                 * _GntMouseEvent
645                 * _GntParamFlags
646                 * _GntProgressBarOrientation
647                 * _GntTreeColumnFlag
648                 * _GntWidgetFlags
650 version 2.13.0:
651         libpurple:
652                 Added:
653                 * purple_uri_escape_for_open
655 version 2.12.0:
656         libpurple:
657                 Added:
658                 * PURPLE_MESSAGE_REMOTE_SEND in PurpleMessageFlags, to specify
659                 messages like _SEND that were sent from another location.
660                 * purple_certificate_get_fingerprint_sha256
661                 * purple_certificate_compare_pubkeys
662                 * PurpleCertificateScheme.get_fingerprint_sha256
663                 * PurpleCertificateScheme.compare_pubkeys
664                 * PURPLE_CERTIFICATE_SCHEME_HAS_FUNC
666 version 2.11.0:
667         libpurple:
668                 Added:
669                 * account-status-changing signal (account signals)
670                 * buddy-removed-from-group signal (blist signals)
671                 * PurpleCommandsUiOps, to allow the UI to override the
672                   built-in handling of commands.
673                 * PurplePrefsUiOps, to allow the UI to override the way global
674                   preferences are stored.
675                 * PurpleAccountPrefsUiOps, to allow the UI to handle storage
676                   of account preferences.
677                 * purple_media_set_encryption_parameters
678                 * purple_media_set_decryption_parameters
679                 * purple_xfer_write_file
680                 * purple_xfer_read_file
681                 * purple_media_set_send_rtcp_mux
682                 * purple_media_backend_set_send_rtcp_mux
684 version 2.10.12:
685         * No changes
687 version 2.10.11:
688         * No changes
690 version 2.10.10:
691         * No changes
693 version 2.10.9:
694         * No changes
696 version 2.10.8:
697         * No changes
699 version 2.10.7:
700         * No changes
702 version 2.10.6:
703         * No changes
705 version 2.10.5:
706         * No changes
708 version 2.10.4:
709         * No changes
711 version 2.10.3:
712         * No changes
714 version 2.10.2:
715         * No changes
717 version 2.10.1:
718         * No changes
720 version 2.10.0:
721         libpurple:
722                 Added:
723                 * purple_srv_txt_query_destroy (accidentally left out of 2.8.0)
725         Pidgin:
726                 Added:
727                 * pidgin_dialogs_plugins_info (should not be used by anything but Pidgin)
729 version 2.9.0:
730         libpurple:
731                 Added:
732                 * Hash table to PurpleConvChat struct, used to make
733                   purple_conv_chat_cb_find O(1).
734                 * ui_data pointer to PurpleConvChatBuddy struct.
735                 * deleting-chat-buddy signal (conversation signals)
736                 * pidgin_pixbuf_from_data
737                 * pidgin_pixbuf_anim_from_data
738                 * pidgin_pixbuf_new_from_file
739                 * pidgin_pixbuf_new_from_file_at_size
740                 * pidgin_pixbuf_new_from_file_at_scale
742                 Deprecated:
743                 * purple_conv_chat_set_users
744                 * PurpleConvChat in_room list
746 version 2.8.0 (06/07/2011):
747         libpurple:
748                 Added:
749                 * account-authorization-requested-with-message signal (Stefan Ott)
750                   (#8690)
751                 * cleared-message-history signal (conversation signals)
752                 * purple_account_add_buddy_with_invite
753                 * purple_account_add_buddies_with_invite
754                 * purple_dnsquery_a_account
755                 * purple_notify_user_info_add_pair_plaintext
756                 * purple_media_get_active_local_candidates
757                 * purple_media_get_active_remote_candidates
758                 * purple_media_manager_get_video_caps (Jakub Adam) (#13095)
759                 * purple_media_manager_set_video_caps (Jakub Adam) (#13095)
760                 * purple_pounce_destroy_all_by_buddy (Kartik Mohta) (#1131)
761                 * purple_proxy_connect_socks5_account
762                 * purple_srv_resolve_account
763                 * purple_txt_resolve_account
764                 * Added add_buddy_with_invite to PurplePluginProtocolInfo
765                 * Added add_buddies_with_invite to PurplePluginProtocolInfo
766                 * Added PurpleSrvTxtQueryUiOps which allow UIs to specify their
767                   own mechanisms to resolve SRV and/or TXT queries. It works
768                   similar to PurpleDnsQueryUiOps
769                 * purple_marshal_BOOLEAN__POINTER_BOOLEAN (kawaii.neko) (#12599)
771                 Deprecated:
772                 * purple_account_add_buddy
773                 * purple_account_add_buddies_with_invite
774                 * purple_dnsquery_a
775                 * purple_proxy_connect_socks5
776                 * purple_srv_resolve
777                 * purple_txt_resolve
778                 * add_buddy from PurplePluginProtocolInfo struct
779                 * add_buddies from PurplePluginProtocolInfo struct
781         Pidgin:
782                 Added:
783                 * pidgin_make_scrollable (Gabriel Schulhof) (#10599)
784                 * chat-nick-clicked signal (kawaii.neko) (#12599)
785                 * chat-nick-autocomplete signal (kawaii.neko) (#12599)
787 version 2.7.11 (03/10/2011):
788         * libpurple:
789                 Added:
790                 * Four entries in the GHashTable passed when joining
791                   an XMPP chat room which allow the UI to request a limited
792                   amount of history.  See XEP-0045 7.1.16 for details; the
793                   entries are named history_maxchars, history_maxstanzas,
794                   history_seconds, and history_since.  history_since must be
795                   interpretable by purple_str_to_time, and the prpl takes care
796                   of formatting the time properly.
797         * Perl:
798                 Added:
799                 * Purple::find_conversation_with_account
800                 * Purple::Conversation::Chat::send_with_flags
801                 * Purple::Conversation::IM::send_with_flags
803 version 2.7.10 (02/06/2011):
804         * No changes
806 version 2.7.9 (12/26/2010):
807         * No changes
809 version 2.7.8 (12/19/2010):
810         * No changes
812 version 2.7.7 (11/23/2010):
813         * No changes
815 version 2.7.6 (11/21/2010):
816         * No changes
818 version 2.7.5 (10/31/2010):
819         * No changes
821 version 2.7.4 (10/20/2010):
822         Perl:
823                 Added:
824                 * Purple::BuddyList::Chat::get_components
826                 Changed:
827                 * Purple::BuddyList::Chat::new now works properly.  Thanks
828                   to Rafael in devel@conference.pidgin.im for reporting and
829                   testing.
831 version 2.7.3 (08/10/2010):
832         libpurple:
833                 Fixed:
834                 * purple_account_[gs]et_public_alias no longer crash when
835                   called for a protocol that doesn't support the underlying
836                   calls and the caller does not specify a failure callback.
838         Perl:
839                 Added:
840                 * Exposed log-subsystem signals.
842         Pidgin:
843                 Changed:
844                 * Changing the visibility (gtk_widget_hide/show) of
845                   the widgets in the GtkIMHtmlToolbar should now affect
846                   the visibility of the entries in the 'lean' view
847                   (the default toolbar view).
849                 Deprecated:
850                 * pidgin_check_if_dir
852         libgnt:
853                 Added:
854                 * gnt_tree_row_get_key, gnt_tree_row_get_next,
855                   gnt_tree_row_get_prev, gnt_tree_row_get_child and
856                   gnt_tree_row_get_parent.
858 version 2.7.2 (07/21/2010):
859         * No changes
861 version 2.7.1 (05/29/2010):
862         * No changes
864 version 2.7.0 (05/12/2010):
865         libpurple:
866                 Added:
867                 * Account signals (see account-signals.dox); useful for D-Bus
868                    * account-signed-on
869                    * account-signed-off
870                    * account-connection-error
871                 * purple_account_get_name_for_display
872                 * purple_account_get_privacy_type
873                 * purple_account_get_public_alias
874                 * purple_account_set_privacy_type
875                 * purple_account_set_public_alias
876                 * buddy-caps-changed blist signal
877                 * Added media_caps to the PurpleBuddy struct
878                 * purple_buddy_get_media_caps
879                 * purple_buddy_set_media_caps
880                 * purple_certificates_import for importing multiple
881                   certificates from a single file (and corresponding
882                   import_certificates member of PurpleCertificateScheme struct)
883                 * autojoin connection signal
884                 * purple_contact_get_group
885                 * sent-attention conversation signal
886                 * got-attention conversation signal
887                 * ui-caps-changed media manager signal
888                 * purple_media_candidate_copy
889                 * purple_media_codec_copy
890                 * purple_media_manager_get_backend_type
891                 * purple_media_manager_set_backend_type
892                 * PurpleMood struct in status.h
893                 * purple_network_get_all_local_system_ips, which returns all
894                   local IPs on the system.  On systems with the getifaddrs()
895                   function, this will return both IPv4 and IPv6 addresses
896                   (excluding link-local and loopback addresses).  On others,
897                   it returns just IPv4 addresses.
898                 * purple_network_listen_family and
899                   purple_network_listen_range_family.  These will replace the
900                   versions without _family in 3.0.0 and allow the caller to
901                   specifically request either an IPv4 or IPv6 socket.  IPv6 is
902                   only supported if the getaddrinfo() function is available
903                   at build-time (not the case on Windows, currently).
904                 * purple_prpl_got_media_caps
905                 * purple_request_action_with_icon
906                 * purple_request_action_with_icon_varg
907                 * purple_socket_get_family
908                 * purple_socket_speaks_ipv4
909                 * purple_unescape_text
910                 * purple_uuid_random
911                 * purple_xfer_get_thumbnail
912                 * purple_xfer_get_thumbnail_mimetype
913                 * purple_xfer_set_thumbnail
914                 * purple_xfer_prepare_thumbnail
916         Pidgin:
917                 Added:
918                 * pidgin_dialogs_buildinfo (should not be used by anything but Pidgin)
919                 * pidgin_dialogs_developers (should not be used by anything but Pidgin)
920                 * pidgin_dialogs_translators (should not be used by anything but Pidgin)
921                 * gtk_imhtmltoolbar_switch_active_conversation
922                 * 'paste' signal for GtkIMHtml (more in gtkimhtml-signals.dox)
923                 * 'drawing-buddy' signal for gtkblist (more in gtkblist-signals.dox)
925 version 2.6.6 (02/18/2010):
926         libpurple:
927                 Changed:
928                 * purple_xfer_cancel_local is now called instead of
929                   purple_xfer_request_denied if an error is found when selecting
930                   a file to send. Request denied is still used when a receive
931                   request is not allowed.
932                 * xmlnode_from_str now properly handles parsing an attribute which
933                   contain "<br>", which were previously transformed into a
934                   newline character (libxml2 unescapes all entities except
935                   representations of '&', and libpurple's purple_unescape_html
936                   converts "<br>" to a newline).
938         Perl:
939                 Changed:
940                 * Corrected the package names for the PurpleProxyType and
941                   PurpleLogReadFlags enums to have the correct number of colons
942                   (from Purple::ProxyType::::<type> to Purple::ProxyType::<type>
943                   and Purple::Log:ReadFlags::::<type> to
944                   Purple::Log::ReadFlags::<type>)  (Chris Foote)
946 version 2.6.5 (01/08/2010):
947         No changes
949 version 2.6.4 (11/29/2009):
950         No changes
952 version 2.6.3 (10/16/2009):
953         No changes
955 version 2.6.2 (09/05/2009):
956         Perl:
957                 Added:
958                 * Purple::XMLNode::get_next(), which returns the next neighbor tag of
959                   the current node.
960                 Changed:
961                 * Purple::XMLNode::get_child() will return the first child node if
962                   passed "" or undef as the name of the node.
964 version 2.6.1 (08/18/2009):
965         No changes
967 version 2.6.0 (08/18/2009):
968         libpurple:
969                 Added:
970                 * PurpleMedia and PurpleMediaManager API
971                 * PURPLE_BLIST_NODE
972                 * PURPLE_GROUP
973                 * PURPLE_CONTACT
974                 * PURPLE_BUDDY
975                 * PURPLE_CHAT
976                 * Account signals (see account-signals.dox)
977                         * account-actions-changed
978                         * account-created
979                         * account-destroying
980                 * blist-node-added and blist-node-removed signals (see
981                   blist-signals.dox)
982                 * Three Blist UI ops used to overload libpurple's built-in saving
983                   of the buddy list to blist.xml. If a UI implements these, it probably
984                   wants to add the buddies itself and not call purple_blist_load.
985                 * Three File Transfer UI ops used to overload libpurple's use of fread
986                   and fwrite for saving a file locally. These allow a UI to stream a
987                   file through a socket without buffering the file on the local disk.
988                 * Jabber plugin signals (see jabber-signals.dox)
989                 * purple_account_remove_setting
990                 * purple_buddy_destroy
991                 * purple_buddy_get_protocol_data
992                 * purple_buddy_set_protocol_data
993                 * purple_buddy_get_local_buddy_alias
994                 * purple_blist_get_buddies
995                 * purple_blist_get_ui_data
996                 * purple_blist_set_ui_data
997                 * purple_blist_node_get_ui_data
998                 * purple_blist_node_set_ui_data
999                 * purple_certificate_check_signature_chain_with_failing
1000                 * purple_chat_destroy
1001                 * purple_connection_get_protocol_data
1002                 * purple_connection_set_protocol_data
1003                 * purple_contact_destroy
1004                 * purple_conv_chat_invite_user
1005                 * purple_debug_is_unsafe
1006                 * purple_debug_is_verbose
1007                 * purple_debug_set_unsafe
1008                 * purple_debug_set_verbose
1009                 * purple_global_proxy_set_info
1010                 * purple_group_destroy
1011                 * purple_ipv4_address_is_valid
1012                 * purple_ipv6_address_is_valid
1013                 * purple_log_get_activity_score
1014                 * purple_markup_is_rtl
1015                 * purple_markup_escape_text
1016                 * purple_network_convert_idn_to_ascii
1017                 * purple_network_force_online
1018                 * purple_network_set_stun_server
1019                 * purple_network_set_turn_server
1020                 * purple_network_get_stun_ip
1021                 * purple_network_get_turn_ip
1022                 * purple_network_remove_port_mapping
1023                 * purple_plugins_get_search_paths
1024                 * purple_proxy_connect_udp
1025                 * purple_prpl_get_media_caps
1026                 * purple_prpl_got_account_actions
1027                 * purple_prpl_initiate_media
1028                 * purple_request_field_get_group
1029                 * purple_request_field_get_ui_data
1030                 * purple_request_field_set_ui_data
1031                 * purple_ssl_connect_with_ssl_cn
1032                 * purple_strequal
1033                 * purple_utf8_strip_unprintables
1034                 * purple_util_fetch_url_request_len_with_account
1035                 * purple_xfer_prpl_ready
1036                 * purple_xfer_ui_ready
1037                 * xmlnode_from_file
1038                 * xmlnode_get_parent
1039                 * xmlnode_set_attrib_full
1040                 * PURPLE_STATUS_MOOD as a new PurpleStatusPrimitive
1042                 Changed:
1043                 * xmlnode_remove_attrib now removes all attributes with the
1044                   same name.  Previously, it would remove the first one found,
1045                   which was completely non-deterministic.  If you want to remove
1046                   the attribute with no namespace, then use NULL with
1047                   xmlnode_remove_with_namespace.
1048                 * Plugins may now emit the jabber-sending-xmlnode signal in order
1049                   to send stanzas; this method is preferred to the prpl send_raw
1050                   function as other plugins listening to the signal see them.
1051                 * The conversation-updated signal with a PURPLE_CONV_UPDATE_TYPING
1052                   update type is emitted when receiving an IM.  Previously, the
1053                   typing state was modified (and the buddy-typing-stopped signal
1054                   emitted), but this signal was not emitted.
1055                 * Added a client_type field in the get_ui_info core UI op. See
1056                   core.h for details.
1057                 * Added introspection of signals exposed via the D-Bus API.
1058                 * purple_find_buddies is now more efficient in the case where
1059                   it is enumerating all the buddies for an account.
1060                 * purple_find_group is now more efficient for large numbers of groups.
1061                 * purple_find_conversation_with_account is more efficient for large
1062                   numbers of concurrent conversations.
1063                 * All DNS routines support internationalized domain names (IDNs) when
1064                   libpurple is compiled with GNU libidn.
1065                 * status is set before emitting signals in purple_xfer_set_status.
1066                 * Creating multiple distinct chats with the same name (i.e. "MSN Chat")
1067                   is deprecated and will be removed in libpurple 3.0.0.
1068                 * purple_xfer_start now accepts -1 as the fd parameter if the protocol
1069                   plugin will administer the transfer itself. 0 is still accepted for
1070                   backward compatibility since older versions of libpurple will not
1071                   accept -1.
1073                 Deprecated:
1074                 * buddy-added and buddy-removed blist signals
1075                 * purple_blist_destroy
1076                 * purple_blist_new
1077                 * purple_buddy_get_local_alias
1078                 * purple_certificate_check_signature_chain
1079                 * purple_ip_address_is_valid
1080                 * purple_notify_user_info_remove_entry
1081                 * purple_set_blist
1082                 * purple_status_type_set_primary_attr
1083                 * purple_status_type_add_attr
1084                 * purple_status_type_add_attrs
1085                 * purple_status_type_add_attrs_vargs
1086                 * purple_status_type_get_primary_attr
1087                 * purple_status_set_attr_boolean
1088                 * purple_status_set_attr_int
1089                 * purple_status_set_attr_string
1090                 * purple_presence_add_status
1091                 * purple_presence_add_list
1092                 * purple_util_fetch_url_request_len
1093                 * xmlnode_set_attrib_with_namespace
1094                 * xmlnode_set_attrib_with_prefix
1096         pidgin:
1097                 Added:
1098                 * gtk_imhtml_class_register_protocol
1099                 * gtk_imhtml_link_get_url, gtk_imhtml_link_get_text_tag,
1100                   gtk_imhtml_link_activate functions to process GtkIMHtmlLink
1101                   objects from GtkIMHtml protocol callbacks.
1102                 * gtk_imhtml_set_return_inserts_newline
1103                 * gtk_imhtml_set_populate_primary_clipboard
1104                 * pidgin_blist_set_theme
1105                 * pidgin_blist_get_theme
1106                 * pidgin_prefs_labeled_password
1107                 * pidgin_smiley_editor_set_data
1108                 * pidgin_sound_is_customized
1109                 * pidgin_utils_init, pidgin_utils_uninit
1110                 * pidgin_notify_pounce_add
1111                 * PidginBlistTheme, PidginBlistThemeLoader API
1112                 * PidginIconTheme, PidginStatusIconTheme, PidginIconThemeLoader
1113                   API
1114                 * pidgin_stock_id_from_status_primitive
1115                 * pidgin_stock_id_from_presence
1117         libgnt:
1118                 Added:
1119                 * GntProgressBar and functions (Saleem Abdulrasool)
1121         perl:
1122                 Added:
1123                 * Purple::XMLNode::get_name()
1125                 Changed:
1126                 * Made a bunch of functions act more perl-like. Call the new()
1127                   functions as Class->new(...) instead of Class::new(...):
1128                         * Purple::Request::Fields::new
1129                         * Purple::Request::Field::new
1130                         * Purple::Request::Field::account_new
1131                         * Purple::Request::Field::bool_new
1132                         * Purple::Request::Field::choice_new
1133                         * Purple::Request::Field::int_new
1134                         * Purple::Request::Field::label_new
1135                         * Purple::Request::Field::list_new
1136                         * Purple::Request::Field::string_new
1137                         * Purple::Request::Field::group_new
1138                 * Make the XMLNode API more perl-like. Don't pass len
1139                   parameters and call them like:
1140                         * $xmlnode->copy()
1141                         * $xmlnode->to_str()
1142                         * $xmlnode->to_formatted_str()
1143                         * Purple::XMLNode::from_str(...)
1144 version 2.5.9 (08/18/2009):
1145         No changes
1147 version 2.5.8 (06/27/2009):
1148         No changes
1150 version 2.5.7 (06/20/2009):
1151         No changes
1153 version 2.5.6 (05/19/2009):
1154         No changes
1156 version 2.5.5 (03/01/2009):
1157         libpurple:
1158                 Changed:
1159                 * purple_status_type_new now defaults "saveable" to TRUE.
1160                   This was necessary in order to maintain the current behavior
1161                   while fixing non-saveable statuses not to be saved.
1162                 * xmlnode_get_prefix, xmlnode_to_str and xmlnode_to_formatted_str
1163                   now all take a const xmlnode* instead of an xmlnode*
1165 version 2.5.4 (01/12/2009):
1166         perl:
1167                 Changed:
1168                 * Purple::PluginPref->get_bounds no longer takes two integer
1169                   arguments it now returns two integers.
1171                 Removed:
1172                 * Removed a handful of string-related utility functions that
1173                   can generally be better handled with perl's built-in string
1174                   functions rather than using pidgin's:
1175                         * Purple::Util::strcasereplace
1176                         * Purple::Util::strcasestr
1177                         * Purple::Util::strreplace
1178                         * Purple::Util::str_strip_char
1179                         * Purple::Util::chrreplace
1181 version 2.5.3 (12/20/2008):
1182         libpurple
1183                 Changed:
1184                 * purple_util_fetch_url and purple_util_fetch_url_request can
1185                   now fetch https URLs
1187 version 2.5.0 (08/18/2008):
1188         libpurple:
1189                 Added:
1190                 * Connection flag PURPLE_CONNECTION_ALLOW_CUSTOM_SMILEY to indicate
1191                   that the connection supports sending and receiving custom smileys.
1192                 * PurpleSmiley and the Smiley API.
1193                 * purple_serv_got_join_chat_failed
1194                 * chat-join-failed signal (see conversation-signals.dox)
1195                 * chat-invite-blocked and blocked-im-msg signals (see
1196                   converation-signals.dox) (Thanks to Stefan Ott)
1197                 * purple_blist_update_node_icon
1198                 * purple_buddy_icons_node_has_custom_icon
1199                 * purple_buddy_icons_node_find_custom_icon
1200                 * purple_buddy_icons_node_set_custom_icon
1201                 * purple_buddy_icons_node_set_custom_icon_from_file
1202                 * purple_notify_user_info_prepend_section_break
1203                 * purple_notify_user_info_prepend_section_header
1204                 * "website" and "dev_website" items to the ui_info hash table
1205                 * purple_cmds_get_handle, purple_cmds_init, purple_cmds_uninit
1206                 * cmd-added and cmd-removed signals
1207                 * purple_get_host_name
1208                 * purple_util_fetch_url_len (temporary function overload to add max_len param)
1209                 * purple_util_fetch_url_request_len
1210                 * purple_prpl_send_attention
1211                 * purple_prpl_got_attention
1212                 * purple_prpl_got_attention_in_chat
1214                 Deprecated:
1215                 * purple_blist_update_buddy_icon
1216                 * purple_buddy_icons_has_custom_icon
1217                 * purple_buddy_icons_find_custom_icon
1218                 * purple_buddy_icons_set_custom_icon
1219                 * pidgin_set_custom_buddy_icon
1220                 * purple_util_fetch_url_len
1221                 * purple_util_fetch_url_request_len
1222                 * serv_send_attention
1223                 * serv_got_attention
1225                 Changed:
1226                 * xmlnode_copy now copies the prefix and namespace map for nodes.
1228         pidgin:
1229                 Added:
1230                 * gtk_imhtml_smiley_create, gtk_imhtml_smiley_reload and
1231                   gtk_imhtml_smiley_destroy to deal with GtkIMHtmlSmiley's.
1232                 * pidgin_pixbuf_from_imgstore to create a GdkPixbuf from a
1233                   PurpleStoredImage.
1234                 * pidgin_themes_smiley_themeize_custom to associate custom smileys to
1235                   a GtkIMHtml widget.
1236                 * GTK_IMHTML_CUSTOM_SMILEY flag for GtkIMHtml.
1237                 * GTK+ Custom Smiley API.
1239 version 2.4.2 (05/17/2008):
1240         perl:
1241                 Added:
1242                 * Purple::Prefs::get_children_names.
1243                 * Purple::timeout_remove.
1244                 Changed:
1245                 * Purple::timeout_add now returns a handle which can be used
1246                   to remove the timeout.
1247                 * Callbacks to Purple::Util::fetch_url and the
1248                   Purple::Request::* functions can now be specified as both
1249                   strings (the name of the callback function) and as coderefs.
1250         Finch:
1251                 libgnt:
1252                 * Added gnt_bindable_check_key to check if a keystroke is bound.
1254 version 2.4.0 (02/29/2008):
1255         libpurple:
1256                 Added:
1257                 * purple_certificate_add_ca_search_path. (Florian Quèze)
1258                 * purple_gai_strerror.
1259                 * purple_major_version, purple_minor_version,
1260                   purple_micro_version variables are exported by version.h,
1261                   giving the version of libpurple in use at runtime.
1262                 * purple_util_set_current_song, purple_util_format_song_info
1263                 * purple_ip_address_is_valid
1264                 * Some accessor functions to the Roomlist API:
1265                         * purple_roomlist_get_fields
1266                         * purple_roomlist_room_get_type
1267                         * purple_roomlist_room_get_name
1268                         * purple_roomlist_room_get_parent
1269                         * purple_roomlist_room_get_fields
1270                         * purple_roomlist_field_get_type
1271                         * purple_roomlist_field_get_label
1272                         * purple_roomlist_field_get_hidden
1273                 * unlocalized_name field in PurpleAttentionType for UIs that need it.
1274                 * Some accessor and mutator functions for PurpleAttentionType:
1275                         * purple_attention_type_set_name
1276                         * purple_attention_type_set_incoming_desc
1277                         * purple_attention_type_set_outgoing_desc
1278                         * purple_attention_type_set_icon_name
1279                         * purple_attention_type_set_unlocalized_name
1280                         * purple_attention_type_get_name
1281                         * purple_attention_type_get_incoming_desc
1282                         * purple_attention_type_get_outgoing_desc
1283                         * purple_attention_type_get_icon_name
1284                         * purple_attention_type_get_unlocalized_name
1285                 * Add some PurpleBuddyListNode accessor functions:
1286                         * purple_blist_node_get_parent
1287                         * purple_blist_node_get_first_child
1288                         * purple_blist_node_get_sibling_next
1289                         * purple_blist_node_get_sibling_prev
1290                 * Added last_received to PurpleConnection, the time_t of the
1291                   last received packet.
1292                 * Added some more accessor functions:
1293                         * purple_chat_get_account
1294                         * purple_chat_get_components
1295                         * purple_connection_get_prpl
1296                         * purple_xfer_get_start_time
1297                         * purple_xfer_get_end_time
1298                 * purple_serv_got_private_alias for prpls to call after receiving a
1299                   private alias from the server.
1301         Pidgin:
1302                 Added:
1303                 * pidgin_create_dialog to create a window that closes on escape. Also
1304                   added utility functions pidgin_dialog_get_vbox_with_properties,
1305                   pidgin_dialog_get_vbox, pidgin_dialog_get_action_area to access the
1306                   contents in the created dialog. (Peter 'fmoo' Ruibal)
1307                 * pidgin_dialog_add_button to add buttons to a dialog created by
1308                   pidgin_create_dialog.
1309                 * GTK_IMHTML_NO_SMILEY for GtkIMHtmlOptions means not to look for
1310                   smileys in the text. (Florian 'goutnet' Delizy)
1311                 * pidgin_auto_parent_window to make a window transient for a suitable
1312                   parent window.
1313                 * pidgin_tooltip_setup_for_treeview, pidgin_tooltip_destroy,
1314                   pidgin_tooltip_show and pidgin_tooltip_setup_for_widget to simplify
1315                   the process of drawing tooltips.
1316                 * pidgin_add_widget_to_vbox to simplify adding a labeled widget to a
1317                   window.
1319                 Deprecated:
1320                 * PIDGIN_DIALOG
1322         Finch:
1323                 * finch_roomlist_get_ui_ops and finch_roomlist_show_all
1324                 * finch_request_field_get_widget to get the widget for a request
1325                   field.
1326                 * finch_blist_get_tree to get the GntTree widget representing the
1327                   buddy list.
1328                 * FinchBlistManager structure to manage the buddylist view, and some
1329                   util functions finch_blist_install_manager,
1330                   finch_blist_uninstall_manager, finch_blist_manager_find and
1331                   finch_blist_manager_add_node.
1332                 * Added finch_log_show, finch_log_show_contact, finch_syslog_show,
1333                   finch_log_init, finch_log_get_handle, finch_log_uninit
1335                 libgnt:
1336                 * Added gnt_tree_set_row_color to set the color for a row in a tree.
1337                 * Added gnt_style_get_string_list
1338                 * Added gnt_color_add_pair to define a new color.
1339                 * Added gnt_colors_get_color to get an ncurses color value from a
1340                   string.
1341                 * Added gnt_style_get_color to get a color pair from an entry in
1342                   ~/.gntrc
1343                 * Added gnt_tree_get_parent_key to get the key for the parent row.
1345 version 2.3.0 (11/24/2007):
1346         libpurple:
1347                 Added:
1348                 * a PurpleConversation field and an alias field in PurpleConvMessage
1349                 * account-authorization signals (see account-signals.dox for
1350                   details) (Stefan Ott)
1351                 * libpurple/purple.h, which includes #define's and #include's
1352                   required to compile stand-alone plugins
1353                 * PURPLE_STATUS_TUNE as a new PurpleStatusPrimitive
1354                 * purple_plugin_disable(), which is intended to be called when
1355                   a purple_plugin_unload()--which was called when a user tried
1356                   to unload a plugin--fails.  This then prevents the plugin
1357                   from being saved in the saved plugins list, so it'll won't
1358                   be loaded at the next startup.
1359                 * PurpleDisconnectReason enumeration of machine-readable
1360                   types of connection error.
1361                 * purple_connection_error_reason(), to be used by prpls
1362                   (instead of purple_connection_error() and setting
1363                   gc->wants_to_die) to report errors along with a
1364                   PurpleDisconnectReason.
1365                 * PurpleConnectionUiOps.report_disconnect_reason, to be
1366                   implemented by UIs (rather than .report_disconnect) if
1367                   they want to use the reported PurpleDisconnectReason
1368                   to give a more specific error.
1369                 * A connection-error signal, fired just after the UiOp is
1370                   called with the same information.
1371                 * purple_connection_reason_is_fatal(), acting as a hint
1372                   to whether automatic reconnection should be attempted
1373                   after a connection error (rather than checking
1374                   gc->wants_to_die).
1375                 * PurpleConnectionErrorInfo, a struct to hold a
1376                   PurpleConnectionError and a const char *description.
1377                 * purple_account_get_current_error() to get the most recent
1378                   PurpleConnectionError and description (or NULL if the
1379                   account is happy with life), to allow bits of the UI to know
1380                   the last error without caching it themselves (as
1381                   PidginBuddyList does).
1382                 * purple_account_clear_current_error() to reset an account's
1383                   error state to NULL.
1384                 * An account-error-changed signal, firing when
1385                   purple_account_get_current_error()'s return value changes.
1387                 * PidginMiniDialog, a Gtk widget-ified version of
1388                   pidgin_make_mini_dialog().
1390                 * purple_util_init()
1391                 * purple_util_uninit()
1393                 * purple_network_listen_map_external() to temporarily disable
1394                   mapping ports externally via NAT-PMP or UPnP.
1396                 Changed:
1397                 * purple_plugin_unload() now honors the return value of a
1398                   plugin's unload function and can actually return FALSE now.
1399                 * purple_plugin_unload() no longer does its own notifications
1400                   when a dependent plugin fails to unload.  The UI should do
1401                   something appropriate.
1403                 * pidgin_make_mini_dialog() now declares its return type to be
1404                   GtkWidget * rather than void *.  This should not break any
1405                   existing code since any code using it must already rely on
1406                   the return type actually being GtkWidget * all along.
1408                 Deprecated:
1409                 * pidgin_dialogs_about()
1410                 * pidgin_log_show_contact()
1411                 * pidgin_log_show()
1412                 * pidgin_plugin_dialog_show()
1413                 * pidgin_pounce_editor_show()
1414                 * pidgin_pounces_manager_show()
1415                 * pidgin_syslog_show()
1417                 * purple_connection_error()
1418                 * pidgin_blist_update_account_error_state()
1419                 * PidginBuddyList.connection_errors
1420                 * purple_network_listen_map_external()
1422                 MSN:
1423                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
1424                   PURPLE_TUNE_ARTIST, PURPLE_TUNE_ALBUM and PURPLE_TUNE_TITLE
1425                   attributes.
1427                 XMPP:
1428                 * A new independant status type with PURPLE_STATUS_TUNE primitive, and
1429                   PURPLE_TUNE_{ARTIST, TITLE, ALBUM, GENRE, COMMENT, TRACK, TIME,
1430                   YEAR, URL} attributes.
1432         Finch:
1433                 libgnt:
1434                 * Added gnt_color_pair, which will try to intelligenty set text
1435                   attributes in place of colors if the terminal doesn't have color
1436                   support. (Bug: #3560) All future code should use gnt_color_pair
1437                   instead of COLOR_PAIR.
1438                 * Added gnt_menuitem_set_id and gnt_menuitem_get_id to set and get the
1439                   string id of a menuitem respectively.
1440                 * Added gnt_window_get_accel_item, which returns a the id of a menuitem
1441                   bound to a keystroke.
1442                 * Added gnt_menu_get_item to get a menuitem of the given id from a
1443                   menu.
1444                 * Added gnt_menuitem_activate, which triggers the 'activate' signal on
1445                   the menuitem and calls the callback function, if available.
1446                 * Added GntEntryKillRing in GntEntry.
1447                 * Added gnt_window_set_maximize and gnt_window_get_maximize, and
1448                   GntWindowFlags enum.
1450 version 2.2.2 (10/23/2007):
1451         libpurple:
1452                 Changed:
1453                 * The size parameter of purple_util_write_data_to_file_absolute
1454                   has been changed to gssize instead of a size_t to correctly
1455                   indicate that -1 can be used for a nul-delimited string.
1456                 * The documentation for purple_savedstatuses_get_popular used to
1457                   incorrectly claim that the active status is excluded from the
1458                   returned list. The documentation has been corrected. Also, the
1459                   function now returns a correct list when called with a value of 0.
1461 version 2.2.0 (09/13/2007):
1462         libpurple:
1463                 Added:
1464                 * PURPLE_MESSAGE_INVISIBLE flag, which can be used by
1465                   purple_conv_im_send_with_flags to send a message, but not display it
1466                   in the conversation
1467                 * serv_send_attention(), serv_got_attention(), as well as send_attention 
1468                   and attention_types in PurplePluginProtocolInfo. This new API is used
1469                   for zapping in MySpaceIM, buzzing in Yahoo, and nudging in MSN.
1470                 * PurpleConvMessage structure to represent a message in a
1471                   conversation. purple_conversation_message_get_sender,
1472                   purple_conversation_message_get_message,
1473                   purple_conversation_message_get_flags and
1474                   purple_conversation_message_get_timestamp to get information about a
1475                   PurpleConvMessage.
1476                 * purple_conversation_get_message_history() to retrieve a list of
1477                   PurpleConvMessage's in a conversation, and
1478                   purple_conversation_clear_message_history to clear the history.
1479                 * purple_certificate_* functions in libpurple/certificate.h - "A public-key certificate API"
1480                 * purple_ssl_get_peer_certificates() and associated field in PurpleSslOps to retrieve a server's presented SSL certificate chain.
1481                 * PurpleSslConnection::verifier to provide a "how to verify the peer's certificates" callback to the SSL handlers. See certificate.h for more on this.
1482                 * 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.
1484                 Changed:
1485                 * purple_prefs_load is now called within purple_prefs_init.
1486                   The UI no longer needs to call it.
1487                 * writing-im-msg now receives the conversation name as the who
1488                   argument if the caller of purple_conversation_write didn't
1489                   provide a value for who.
1491         Pidgin:
1492                 Added:
1493                 * pidgin_set_accessible_relations, sets up label-for and labelled-by
1494                   ATK relations (broken out from pidgin_set_accessible_label)
1495                 * pidgin_conv_attach_to_conversation, to reattach the Pidgin UI to a
1496                   conversation
1497                 * conversation-hiding and conversation-displayed signals.
1498                 * pidgin_text_combo_box_entry_new, pidgin_text_combo_box_entry_get_text
1499                   and pidgin_text_combo_box_entry_set_text
1501                 Changed:
1502                 * pidgin_conversations_fill_menu now also adds a separator and a 'Show
1503                   All' item if there are more than one conversations in the list.
1505         Finch:
1506                 Added:
1507                 * finch_sound_is_enabled
1508                 * The reserved field in the FinchConv is now used to store information
1509                   about the conversation (using FinchConversationFlag)
1510                 * finch_account_dialog_show
1512                 libgnt:
1513                 * gnt_slider_set_small_step, gnt_slider_set_large_step to allow more
1514                   fine tuned updates of a GntSlider
1515                 * gnt_util_parse_xhtml_to_textview to parse XHTML strings in a
1516                   GntTextView (this works only if libxml2 is available)
1518 version 2.1.1 (08/20/2007):
1519         libpurple:
1520                 Changed:
1521                 * PurpleAccountUiOps.request_authorize's authorize_cb and
1522                   deny_cb parameters now correctly have type
1523                   PurpleAccountRequestAuthorizationCb rather than GCallback.
1524                   (You'll want to change your UI's implementation's signature
1525                   to avoid warnings, and then remove some now-redundant casts
1526                   back to the proper type.)
1528 version 2.1.0 (7/28/2007):
1529         libpurple:
1530                 Added:
1531                 * purple-remote: added getstatus command
1532                 * conversation-extended-menu signal (See Doxygen docs)
1533                 * OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
1534                   slash commands are "native" to the protocol
1535                 * PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
1536                   should not be auto-linkified
1537                 * PurpleEventLoopUiOps.timeout_add_seconds
1538                     UIs can now use better scheduling for whole-second timers.  For
1539                     example, clients based on the glib event loop can now use
1540                     g_timeout_add_seconds.
1541                 * purple_blist_node_get_type
1542                 * purple_conversation_do_command
1543                 * purple_conversation_get_extended_menu
1544                 * purple_core_ensure_single_instance
1545                     This is for UIs to use to ensure only one copy is running.
1546                 * purple_dbus_is_owner
1547                 * purple_timeout_add_seconds
1548                     Callers should prefer this to purple_timeout_add for timers
1549                     longer than 1 second away.  Be aware of the rounding, though.
1550                 * purple_xfer_get_remote_user
1551                 * purple_pounces_get_all_for_ui
1552                 * purple_prefs_get_children_names
1553                 * added displaying-email-notification and 
1554                   displaying-emails-notification signals
1556                 Changed:
1557                 * The documentation of the following functions now properly
1558                   declares that the returned value must not be modified or
1559                   freed, which was always the case:
1560                         * purple_accounts_get_all
1561                         * purple_connections_get_all
1562                         * purple_connections_get_connecting
1563                         * purple_conv_chat_get_ignored
1564                         * purple_conv_chat_get_users
1565                         * purple_get_chats
1566                         * purple_get_conversations
1567                         * purple_get_ims
1568                         * purple_notify_user_info_get_entries
1569                 * The following functions now return a GList* instead of a
1570                   const GList*, as const is not very useful with GLists.  The
1571                   returned value still must not be modified or freed:
1572                         * purple_account_get_status_types
1573                         * purple_mime_document_get_fields
1574                         * purple_mime_document_get_parts
1575                         * purple_mime_part_get_fields
1576                         * purple_request_fields_get_required
1577                         * purple_request_field_list_get_selected
1578                         * purple_request_field_list_get_items
1579                         * purple_status_type_get_attrs
1580                         * purple_presence_get_statuses
1581                 * purple_request_field_list_set_selected now takes a GList*
1582                   instead of a const GList* for items, as const is not very
1583                   useful with GLists.  The passed list is still not modified
1584                   or freed.
1585                 * purple_presence_add_list now takes a GList* instead of a
1586                   const GList* for source_list, as const is not very useful with
1587                   GLists.  The passed list is still not modified or freed.
1589         Pidgin:
1590                 Added:
1591                 * gtk_imhtml_setup_entry
1592                 * pidgin_create_window
1593                 * pidgin_retrieve_user_info and pidgin_retrieve_user_info_in_chat,
1594                   shows immediate feedback when getting information about a user.
1595                 * gtk_imhtml_animation_new
1596                     Can be used for inserting an animated image into an IMHTML.
1597                 * pidgin_menu_position_func_helper
1598                 * pidgin_blist_get_name_markup, returns the buddy list markup
1599                   text for a given buddy.
1600                 * pidgin_blist_draw_tooltip and pidgin_blist_tooltip_destroy
1601                   for creating blist tooltips from outside of buddy list code
1602                 * pidgin_themes_remove_smiley_theme
1604                 Changed:
1605                 * pidgin_append_menu_action returns the menuitem added to the menu.
1606                 * pidgin_separator returns the separator added to the menu.
1607                 * PidginConversation has struct members to handle the new info
1608                   pane:
1609                         * infopane
1610                         * infopane_hbox
1611                         * infopane_model
1612                         * infopane_iter
1614         Finch:
1615                 Added:
1616                 * finch_retrieve_user_info
1618                 libgnt:
1619                         Added:
1620                         * GntWS for workspaces
1621                         * gnt_tree_set_column_title
1622                         * GntSlider widget
1623                         * "completion" signal for GntEntry
1624                         * "terminal-refresh" signal for GntWM, with a corresponding entry
1625                           in GntWMClass
1626                         * New flags for GntTextView to decide whether to word-wrap or show
1627                           scrollbars (GntTextViewFlag) which can be set by
1628                           gnt_text_view_set_flag
1629                         * gnt_style_get_from_name
1630                         * gnt_window_present
1631                         * gnt_tree_set_column_width_ratio
1632                         * gnt_tree_set_column_resizable
1633                         * gnt_tree_set_column_is_right_aligned
1634                         * gnt_tree_set_search_function, gnt_tree_set_search_column,
1635                           gnt_tree_is_searching
1636                         * 'file-selected' signal is emited for GntFileSel
1637                         * gnt_style_parse_bool
1638                         * gnt_util_set_trigger_widget
1640                         Changed:
1641                         * gnt_tree_get_rows() now returns a GList* instead of a const
1642                           GList*, as const is not very useful with GLists.  The
1643                           returned value still must not be modified or freed.
1644                         * Instead of keeping an 'invisible' item, the GntTreeColumns now
1645                           maintain 'flags' with the appropriate flags set
1647 version 2.0.2 (6/14/2007):
1648         Pidgin:
1649                 Deprecated:
1650                 * pidgin_dialogs_alias_contact:  This will be removed in 3.0.0
1651                   unless there is sufficient demand to keep it.
1653 version 2.0.0 (5/3/2007):
1654         Please note all functions, defines, and data structures have been
1655         re-namespaced to match the new names of Pidgin, Finch, and libpurple.
1656         All gaim_gtk_* functions are now pidgin_*, former libgaim functions are
1657         now purple_*.  Please consult our doxygen documentation for a complete
1658         reference.
1660         The gaim-compat.h header exists to provide an API compatibility layer
1661         for libpurple functions.  As an API compatibility layer, it must be
1662         included at compile time to be of use.
1664         Changed:
1665         * All the status stuff.  Yay!
1666         * gaim_prefs_connect_callback(), added handle parameter
1667         * gtk_imhtml_toolbar now descends from GtkHBox making it easier to add your
1668           own widgets to it
1669         * gaim_find_conversation_with_account, added a "type" parameter
1670         * gaim_gtk_prefs_labeled_spin_button, the "key" parameter is now a
1671           const char* instead of just a char*
1672         * gaim_gtk_prefs_labeled_entry, the "key" parameter is now a const char*
1673           instead of just a char*
1674         * the add_buddy perl sub.  The sub now takes the account as the first
1675           argument, and buddy and group as the second and third.  It also adds
1676           the buddy to the server-side buddy list of the given account.
1677         * gaim_connection_new, gaim_account_connect and gaim_account_register no
1678           longer return a GaimConnection
1679         * keep_alive in GaimConnection is renamed to keepalive
1680         * gaim_mkstemp, added a second argument, a boolean, of whether or not the
1681           file is binary
1682         * gaim_log_logger_new, rewritten
1683         * gaim_conv_window_remove_conversation()'s last argument to be a
1684           GaimConversation.
1685         * A new blocked icon: pixmaps/status/default/blocked.png
1686         * In pixmaps/status/default: extendedaway.png renamed to extended_away.png
1687         * In pixmaps/status/default: na.png renamed to unavailable.png
1688         * gtk_imhtml_toggle_bold(): No longer returns a value
1689         * gtk_imhtml_toggle_italic(): No longer returns a value
1690         * gtk_imhtml_toggle_underline(): No longer returns a value
1691         * gtk_imhtml_toggle_strike(): No longer returns a value
1692         * gtk_imhtml_scroll_to_end(): Added the smooth paramter
1693         * gaim_log_new(), added conv parameter
1694         * gaim_buddy_icon_new(), leaves a reference which the caller owns.  Use
1695           gaim_buddy_icon_unref() immediately if you don't want a reference (the
1696           old behavior).
1697         * GAIM_CONV_UNKNOWN to GAIM_CONV_TYPE_UNKNOWN.
1698         * GAIM_CONV_IM to GAIM_CONV_TYPE_IM.
1699         * GAIM_CONV_CHAT to GAIM_CONV_TYPE_CHAT.
1700         * GAIM_CONV_MISC to GAIM_CONV_TYPE_MISC.
1701         * GAIM_CONV_ANY to GAIM_CONV_TYPE_ANY.
1702         * GaimConversationUiOps.write_conv, Replaced const char *who with
1703           const char *name, const char *alias
1704         * gaim_conv_chat_add_users(), added extra_msgs and new_arrivals (pass NULL
1705           and FALSE respectively, to get the same behavior as before)
1706         * chat_add_users in GaimConversationUiOps, added cbuddies and 
1707           new_arrivals and removed buddies.
1708         * chat_rename_user in GaimConversationUiOps, added new_alias
1709         * gaim_conv_chat_cb_new(), added alias. (pass NULL to get the same
1710           behavior as before).
1711         * GaimConversation.log became GList * GaimConversation.logs, so that a
1712           conversation can have multiple logs at once
1713         * gaim_conv_chat_add_user, added extra_msgs
1714         * gaim_notify_userinfo, removed primary and secondary parameters
1715         * GaimNotifyUiOps.notify_userinfo: removed title, primary, and
1716           secondary parameters
1717         * Idle timers are now added and removed in gtkidle.c in response
1718           to the signed-on and signed-off signals
1719         * GaimXfer->ops.read, GaimXfer->ops.write, gaim_xfer_set_read_fnc(),
1720           gaim_xfer_set_write_fnc(), gaim_xfer_read(), gaim_xfer_write():
1721           Changed ssize_t to gssize
1722         * serv_got_im, serv_got_chat_in, serv_send_im and serv_chat_send all use
1723           GaimMessageFlags instead of GaimConvImFlags / GaimConvChatFlags
1724         * All core<->prpl message passing now uses html.  This was previously true
1725           for receiving messages, it's now also true for sending them.  prpls that
1726           don't support html need to gaim_unescape_html() the message.
1727         * Notify API: GCallback -> GaimNotifyCloseCallback,
1728                       void *user_data -> gpointer user_data
1729         * gaim_notify_searchresults_get_rows_count,
1730           gaim_notify_searchresults_get_columns_count: return type now guint
1731         * gaim_account_notify_added: No longer checks if there is a
1732           GaimBuddy for the added user, that's left up to the prpls.  See the
1733           documentation for this function and gaim_account_request_add.
1734         * gaim_accounts_reorder: new_index is now a gint instead of a size_t
1735         * displaying-message signals: displaying-[im|chat]-msg and
1736           displayed-[im|chat]-msg signals are emitted for all messages
1737           (ie, for received messages, sent messages, system messages, error
1738           messages etc.), and the signals now have
1739           gaim_gtk_conversations_get_handle() for their handle.
1740         * GAIM_NOTIFY_BUTTON_ADD_BUDDY to GAIM_NOTIFY_BUTTON_ADD
1741         * conversation-switched: This signal has been moved from conversation to
1742                                  the UI and the signal-handlers only receive the
1743                                  conversation that has been switched to.
1744         * GaimPluginProtocolInfo: Added offline_message
1745         * GaimPluginProtocolInfo: Added whiteboard_prpl_ops
1746         * GaimPluginProtocolInfo: Added media_prpl_ops
1747         * GaimPluginProtocolInfo: Added "user_info" argument to tooltip_text,
1748                                   changed the return type to void
1749         * GaimPluginProtocolInfo: Added "full" argument to tooltip_text
1750         * gaim_pounce_new(): Added option argument for pounce options
1751         * gaim_network_listen() and gaim_network_listen_range(): Added
1752           socket_type parameter to allow creation of UDP listening. Modified
1753           to be asynchronous with a callback to allow for UPnP operation.
1754           Returns a data structure that can be used to cancel the listen
1755           attempt using gaim_network_listen_cancel()
1756         * GaimPrefCallback: val is now a gconstpointer instead of a gpointer
1757         * gtk_imhtml_get_current_format(): the arguments are now set to TRUE or
1758           FALSE.  Previously they were set to TRUE or left alone.  Also, you
1759           may now pass NULL if you're not interested in a specific formatting.
1760         * Smiley Themes: Backslashes must be backslash-escaped.
1761         * Plugins: Depedencies are now honored when unloading plugins.
1762         * gaim_markup_extract_info_field(): Added format_cb parameter.
1763         * gaim_markup_extract_info_field(): Changed GString parameter to a GaimNotifyUserInfo paramter.
1764         * gaim_str_to_time(): Added support for parsing the MM/DD/YYYY format.
1765         * gaim_plugin_action_new(): label is now const char *
1766         * gaim_plugin_pref_new_with_name(): name is now const char *
1767         * gaim_plugin_pref_new_with_label(): label is now const char *
1768         * gaim_plugin_pref_new_with_name_and_label(): name and label are
1769           now const char *
1770         * gaim_plugin_pref_set_name(): name is now const char *
1771         * gaim_plugin_pref_get_name(): return type is now const char *
1772         * gaim_plugin_pref_set_label(): label is now const char *
1773         * gaim_plugin_pref_get_label(): return type is now const char *
1774         * gaim_plugin_pref_add_choice(): label is now const char *
1775         * struct proto_chat_entry: label is now const char *
1776         * struct proto_chat_entry: identifier is now const char *
1777         * All network activity has been updated to use non-blocking sockets.
1778           This means that plugins must be updated to expect such a socket from
1779           gaim_proxy_connect() and gaim_network_listen*().
1780         * gaim_proxy_connect(): changed to return NULL on error and a pointer
1781           to a GaimProxyConnectInfo object which can be used to cancel
1782           connection attempts using gaim_proxy_connect_cancel().  Also added
1783           a 'handle' parameter that can be used to cancel the connection
1784           attempt using gaim_proxy_connect_cancel_with_handle().
1785         * gaim_gethostbyname_async(): Renamed to gaim_dnsquery_a() and
1786           changed to return a pointer to a data structure that can be
1787           used to cancel the pending DNS query using gaim_dnsquery_destroy()
1788         * gaim_url_fetch(): Renamed to gaim_util_fetch_url() and changed
1789           to return a pointer to a data structure that can be used to cancel
1790           the pending HTTP request using gaim_util_fetch_url_cancel().
1791           Corresponding callback has changed to accept this data structure
1792           as its first argument, and to accept an error message as an
1793           additional final argument.
1794         * gaim_gtk_create_imhtml(): Added sw_ret() parameter
1795         * gaim_account_get_log(): Added create parameter
1796         * GAIM_CMD_P_VERYHIGH is now GAIM_CMD_P_VERY_HIGH
1797         * gtk_imhtml_search_find(): Now wraps around to the top instead of
1798           clearing the search at the end.
1799         * gaim_gtkxfer_dialog_show: Can now take NULL to show (and possibly
1800           create) a default gtkxfer dialog.
1801         * CHAT_USERS_BUDDY_COLUMN became CHAT_USERS_WEIGHT_COLUMN, along with
1802           a change in the values stored in the column.
1803         * gaim_find_buddies() returns a list of all buddies in the account if name
1804           is NULL.
1805         * gaim_gtk_set_custom_buddy_icon() sets custom icon for a user.
1806         * Hid the definition of _GaimStringref, which already had a warning to
1807           avoid accessing it directly.
1808         * notify_userinfo() UI op is passed a GaimNotifyUserInfo instead of a char*
1809           for the user information
1810         * gaim_buddy_icon_get_scale_size() and was changed to ALWAYS scale
1811           the icon instead of only when icon_spec->scale_rules contains
1812           GAIM_ICON_SCALE_DISPLAY.  Callers should be changed to check the
1813           scale_rules before calling this function.
1814         * gaim_gtk_buddy_icon_get_scale_size() was changed to accept an
1815           additional parameter which is used to determine what kind of
1816           scaling should be done, if any.
1817         * purple_request_input(), purple_request_choice(),
1818           purple_request_choice_varg(), purple_request_action(),
1819           purple_request_action_varg(), purple_request_fields(),
1820           purple_request_yes_no(), purple_request_ok_cancel(),
1821           purple_request_accept_cancel(), purple_request_file(), and
1822           purple_request_folder() was changed to accept account, who, and
1823           conversation parameters for associating the request with an account, a
1824           buddy, or a conversation.
1825         * Significant changes to the buddy icon and imgstore APIs.  If you
1826           were using any of it, it's best to look at the header files or
1827           Doxygen documentation, but here are some significant changes:
1828             purple_buddy_icon_new() now takes ownership of ("frees") icon_data
1829             purple_buddy_icon_set_data(): likewise for data
1830             purple_buddy_icon_set_for_user(): likewise for data
1831             purple_buddy_icon_set_for_user() now takes a checksum parameter
1832             purple_imgstore_add() was renamed to purple_imgstore_add_with_id()
1833               which takes ownership of data
1835         Removed:
1836         * gaim_gtk_sound_{get,set}_mute() (replaced by the /gaim/gtk/sound/mute
1837           preference)
1838         * gaim_escape_html(const char *html) (use g_markup_escape_text(html, -1)
1839           instead)
1840         * gaim_accounts_sync, account changes are now scheduled to be saved
1841           automatically
1842         * gaim_connection_connect
1843         * gaim_connection_disconnect
1844         * gaim_connection_register
1845         * gaim_accounts_auto_login
1846         * gaim_find_conversation, use gaim_find_conversation_with_account instead
1847         * gaim_chat_get_display_name
1848         * gaim_conversation_set_history, gaim_conversation_get_history, and
1849           GaimConversation->history.  Use gtk_imhtml_get_markup instead.
1850         * set_gaim_user_dir to gaim_util_set_user_dir
1851         * create_prpl_icon to gaim_gtk_create_prpl_icon
1852         * Window flashing support in the core: gaim_conv_window_flash, and flash UI
1853           operation for conversations.  Use signal "received-im-msg" or similar.
1854         * All warning stuff from the core.
1855         * gaim_gtkconv_get_dest_tab_at_xy(), instead use gaim_gtkconv_get_tab_at_xy()
1856         * chat_add_user from GaimConversationUiOps: only chat_add_users is used
1857         * chat_remove_user from GaimConversationUiOps: only chat_remove_users is used
1858         * uc from the GaimBuddy struct
1859         * gaim_sound_get_handle()
1860         * gaim_debug_vargs()
1861         * serv_add_buddy(); use gaim_account_add_buddy() instead
1862         * serv_add_buddies(); use gaim_account_add_buddies() instead
1863         * serv_change_passwd(); use gaim_account_change_password() instead
1864         * serv_close()
1865         * serv_finish_login()
1866         * serv_login()
1867         * serv_remove_buddy(); use gaim_account_remove_buddy() instead
1868         * serv_remove_buddies(); use gaim_account_remove_buddies() instead
1869         * serv_rename_group()
1870         * serv_set_buddyicon(): use gaim_account_set_buddy_icon() instead
1871         * serv_touch_idle(): use gaim_gtk_check_idle() instead
1872         * GaimGtkImPane->a_virgin
1873         * gaim_str_strip_cr(); use gaim_str_strip_char(str, '\r') instead
1874         * gaim_find_buddys_group renamed to gaim_buddy_get_group
1875         * gaim_gtkpounce_menu_build()
1876         * gaim_gtkpounce_dialog_show()
1877         * GaimGtkBuddyList->bpmenu
1878         * GaimConvImFlags and GaimConvChatFlags; use GaimMessageFlags instead
1879         * cb and user_data from the ops in GaimNotifyUiOps: This is now handled
1880           by the notify API in the core.
1881         * GaimConversationUiOps.updated: use the conversation-updated signal
1882         * GAIM_SUBTYPE_CONV_WINDOW: windows are now only represented in the UI,
1883           so GAIM_TYPE_BOXED is used for the signal types
1884         * gaim_gtk_privacy_is_showable(): We do fallback privacy in the core
1885           now, so this would always be TRUE now.
1886         * GaimBlistNodeAction: See GaimMenuAction
1887         * gaim_blist_node_action_new(); use gaim_menu_action_new() instead
1888         * gaim_date()
1889         * gaim_date_full(): See gaim_date_format_full()
1890         * gaim_strftime(): See gaim_utf8_strftime()
1891         * GAIM_MESSAGE_COLORIZE
1892         * user_data from gaim_notify_searchresults_new_rows and from 
1893           notify_searchresults in GaimNotifyUiOps.
1894         * gaim_conversation_get_send_history(), and send_history from
1895           GaimConversation
1896         * Removed ui_ops from GaimBuddyList. Use gaim_blist_get_ui_ops() instead
1897         * GaimGtkConversation: dialogs (dialogs.search moved to GaimGtkWindow)
1898         * gaim_show_xfer_dialog: Use gaim_gtk_xfer_dialog_show(NULL) instead.
1899         * GaimGtkRoomlistDialog: Nothing used it outside of the file it was in.
1900         * gaim_gtk_roomlist_dialog_new: use gaim_gtk_roomlist_show
1901         * gaim_gtk_roomlist_dialog_new_with_account: use gaim_gtk_roomlist_show_with_account
1902         * binreloc functions
1904         Added:
1905         * gaim_prefs_disconnect_by_handle()
1906         * a password field to GaimConnection, which only persists for the
1907           session (when "remember password" is false, account->password is
1908           NEVER set) Use gaim_connection_get_password(GaimConnection *gc)
1909         * gaim_log_common_writer, gaim_log_common_lister, gaim_log_common_sizer,
1910           and gaim_log_get_log_dir to allow log formats that use standard Gaim
1911           log directory to use Gaim's built-in code for these purposes.
1912         * GaimLogCommonLoggerData struct for a basic logger_data struct to be
1913           used with "common" logger functions.
1914         * gaim_gtk_blist_node_is_contact_expanded, returns TRUE if the given
1915           blist node is a buddy inside an expanded contact, or is itself an
1916           expanded contact
1917         * GaimLogSet struct, get_log_sets function to GaimLogLogger,
1918           gaim_log_get_log_sets, gaim_log_set_compare
1919         * gaim_privacy_check(), to check if a given user is allowed to send
1920           messages to the specified account
1921         * gtk_imhtml_clear_formatting()
1922         * gtk_imhtml_delete to clear out part of a imhtml buffer
1923         * gtk_imhtml_get_protocol_name()
1924         * gaim_buddy_icons_get_full_path(), to get the full path of a buddy
1925           icon setting
1926         * CHAT_USERS_ALIAS_COLUMN, CHAT_USERS_COLOR_COLUMN,
1927           CHAT_USERS_BUDDY_COLUMN to the list of columns for the chat
1928           user list
1929         * gaim_account_add_buddy()
1930         * gaim_account_add_buddies()
1931         * gaim_account_remove_buddy()
1932         * gaim_account_remove_buddies()
1933         * gaim_account_change_password()
1934         * gaim_account_supports_offline_message()
1935         * gaim_conversation_close_logs(), to force a conversation's log(s) to
1936           be closed.  New logs will be opened as necessary.
1937         * gaim_got_protocol_handler_uri()
1938         * gaim_plugin_get_id()
1939         * gaim_plugin_get_name()
1940         * gaim_plugin_get_version()
1941         * gaim_plugin_get_summary()
1942         * gaim_plugin_get_description()
1943         * gaim_plugin_get_author()
1944         * gaim_plugin_get_homepage()
1945         * gaim_gtkconv_switch_active_conversation(GaimConversation *)
1946         * gaim_str_strip_char() to strip a given character from
1947           a given string
1948         * gaim_util_chrreplace() to replace a given character with a
1949           different character
1950         * gaim_gtk_blist_toggle_visibility() to intelligently toggle the
1951           visiblity of the buddy list
1952         * gaim_gtk_blist_visibility_manager_add() to indicate the addition of a
1953           visibility manager - see the docs for more information
1954         * gaim_gtk_blist_visibility_manager_remove() to indicate the removal of
1955           a visibility manager - see the docs for more information
1956         * gaim_gtk_conversations_find_unseen_list() to get a list of conversations
1957           with an "unseen" state >= to the specified state and other criteria
1958         * gaim_gtk_conversations_fill_menu() fill a menu from list of conversations
1959         * gaim_gtk_create_prpl_icon()
1960         * gaim_gtk_create_prpl_icon_with_status()
1961         * gaim_gtk_pounces_manager_show()
1962         * gaim_gtk_pounces_manager_hide()
1963         * gaim_gtk_pounce_editor_show()
1964         * GAIM_POUNCE_MESSAGE_RECEIVED
1965         * GaimPounceOption
1966         * gaim_pounce_set_options()
1967         * gaim_pounce_set_options()
1968         * GAIM_STOCK_CONNECT, GAIM_STOCK_DISCONNECT
1969         * GAIM_STOCK_PLUGIN
1970         * gaim_account_request_add: Notifies the user that they were added to
1971                                     someone's buddy list, and offers them the choice
1972                                     of adding that person to their buddy list.
1973         * gaim_blist_alias_contact()
1974         * gaim_cipher_http_digest_calculate_session_key()
1975         * gaim_cipher_http_digest_calculate_response()
1976         * gaim_notify_searchresults_labeled()
1977         * GAIM_NOTIFY_BUTTON_LABELED, GAIM_NOTIFY_BUTTON_INFO,
1978           GAIM_NOTIFY_BUTTON_IM, GAIM_NOTIFY_BUTTON_JOIN,
1979           GAIM_NOTIFY_BUTTON_INVITE
1980         * stock buttons GAIM_STOCK_IM, GAIM_STOCK_INFO
1981         * gaim_conversation_present()
1982         * GaimConversationUiOps->present(GaimConversation *)
1983         * GaimPlugin.unloadable
1984         * gaim_plugin_is_unloadable()
1985         * GAIM_PLUGIN_PREF_STRING_FORMAT
1986         * gaim_plugin_pref_get_format_type()
1987         * gaim_plugin_pref_set_format_type()
1988         * GaimStringFormatType
1989         * gaim_log_get_handle()
1990         * gaim_log_uninit()
1991         * GAIM_SUBTYPE_LOG
1992         * gaim_marshal_POINTER__POINTER_POINTER
1993         * gaim_utf8_ncr_encode()
1994         * gaim_gtk_log_init()
1995         * gaim_gtk_log_get_handle()
1996         * gaim_gtk_log_uninit()
1997         * gaim_util_fetch_url_request()
1998         * GaimMenuAction
1999         * gaim_menu_action_new()
2000         * gaim_menu_action_free()
2001         * GaimInfoFieldFormatCallback
2002         * gaim_utf8_strftime()
2003         * gaim_date_format_short()
2004         * gaim_date_format_long()
2005         * gaim_date_format_full()
2006         * gaim_time_format()
2007         * gaim_plugin_action_free()
2008         * GaimRequestType: Added GAIM_REQUEST_FOLDER
2009         * GaimRequestUiOps: Added request_folder
2010         * gaim_request_folder()
2011         * gaim_gtk_setup_screenname_autocomplete()
2012         * gaim_gtk_set_cursor()
2013         * gaim_gtk_clear_cursor()
2014         * GAIM_MESSAGE_ACTIVE_ONLY
2015         * gaim_proxy_get_setup()
2016         * GaimNotifySearchResultsCallback: Added user_data.
2017         * gaim_notify_searchresults: Added user_data.
2018         * gaim_network_listen_cancel(): Can be used to cancel a previous
2019           call to gaim_network_listen() or gaim_network_listen_range()
2020         * gaim_proxy_connect_cancel(): Can be used to cancel a pending
2021           gaim_proxy_connect() request
2022         * gaim_proxy_connect_cancel_with_handle(): Can be used to cancel
2023           a previous gaim_proxy_connect() request using a specified handle
2024         * gaim_dnsquery_destroy(): Can be used to cancel a pending DNS
2025           query.
2026         * gaim_util_fetch_url_cancel(): Can be used to cancel a pending
2027           call to gaim_util_fetch_url() or gaim_util_fetch_url_request().
2028         * GaimGtkWindow: dialogs.search (previously in GaimGtkConversation)
2029         * gaim_buddy_get_server_alias()
2030         * gaim_conv_send_confirm()
2031         * GaimConversationUiOps.send_confirm
2032         * gaim_gtk_roomlist_dialog_show_with_account
2033         * gaim_gtk_tree_view_search_equal_func to be used with
2034           gtk_tree_view_set_search_equal_func
2035         * gaim_xfer_set_bytes_sent().  Sets the offset in the file to
2036           read from or write to.
2037         * gaim_privacy_deny and gaim_privacy_allow
2038         * gaim_gtk_blist_set_headline
2039         * gaim_gtk_set_urgent
2040         * GtkGaimScrollBook and its functions.
2041         * purple_markup_unescape_entity()
2042         * purple_markup_get_css_property()
2043         * purple_group_get_name()
2045         Signals - Changed:  (See the Doxygen docs for details on all signals.)
2046         * Signal propagation now stops after a handler returns a non-NULL value.
2047           This value is now returned.  Previously, all registered handlers were
2048           called and the value from the last handler was used.
2049         * "buddy-typing" and "buddy-typing-stopped": replaced the GaimConversation*
2050           with GaimAccount*, const char *name.  Also, the signal is now emitted
2051           regardless of whether a conversation exists and regardless of whether
2052           the user is on the buddy list.
2053         * "chat-buddy-joined": added the new_arrival argument
2054         * "chat-invited" handlers can now return a value to control what happens
2055           to the invite (accept, reject, prompt the user).
2056         * "chat-left": Emitted *after* setting chat->left to TRUE.
2057         * "drawing-tooltip": the second argument is now a GString* instead of
2058           a char**
2059         * "drawing-tooltip": added the "full" argument
2060         * "received-im-msg" and "received-chat-msg" to match, both now pass a
2061           conversation pointer and flags
2062         * "receiving-im-msg" and "receving-chat-msg" to match, both now pass a
2063           conversation pointer and a pointer to the flags.
2064         * "writing-im-msg", "wrote-im-msg", "writing-chat-msg", "wrote-chat-msg":
2065           Now emitted from a difference place in the message handling code.
2066           The arguments also changed.
2067         * "displaying-im-msg", "displayed-im-msg", "displaying-chat-msg",
2068           "displayed-chat-msg": Added "who" argument, which changes the order
2069           of the existing arguments.
2071         Signals - Added:  (See the Doxygen docs for details on all signals.)
2072         * "account-disabled"
2073         * "account-status-changed"
2074         * "account-alias-changed"
2075         * "cipher-added"
2076         * "cipher-removed"
2077         * "conversation-dragging"
2078         * "dbus-method-called"
2079         * "dbus-introspect"
2080         * "file-recv-accept"
2081         * "file-recv-start"
2082         * "file-recv-cancel"
2083         * "file-recv-complete"
2084         * "file-recv-request"
2085         * "file-send-accept"
2086         * "file-send-start"
2087         * "file-send-cancel"
2088         * "file-send-complete"
2089         * "buddy-added"
2090         * "buddy-removed"
2091         * "blist-node-aliased"
2092         * "buddy-status-changed"
2093         * "buddy-idle-changed": A buddy's idle status changed.
2094         * "buddy-icon-changed"
2095         * "buddy-got-login-time": The login time for a buddy is now known
2096         * "displaying-userinfo"
2097         * "gtkblist-hiding"
2098         * "gtkblist-unhiding"
2099         * "log-displaying"
2100         * "network-configuration-changed"
2101         * "savedstatus-changed"
2102         * "sendto-extended-menu"
2103         * "uri-handler"
2105         Signals - Removed:
2106         * "account-away": replaced by account-status-changed
2107         * "account-warned"
2108         * "buddy-away": replaced by buddy-status-changed
2109         * "buddy-back": replaced by buddy-status-changed
2110         * "buddy-idle": replaced by buddy-idle-changed
2111         * "buddy-unidle": replaced by buddy-idle-changed
2112         * "buddy-icon-cached": replaced by buddy-icon-changed
2113         * "conversation-drag-end": replaced by conversation-dragging
2114         * "conversation-switching"
2116 version 1.5.0 (8/11/2005):
2117         * Added: gaim_xfer_conversation_write
2118           Writes a messages to a conversation window with the use
2119           of the associated file transfer.
2121 version 1.4.0 (7/7/2005):
2122         * Added: gaim_buddy_icon_uncache()
2123           Deletes a cached buddy icon for a specified buddy
2124         * Added: gaim_buddy_icon_get_type
2125           Attempts to determine the type of a given buddy icon.
2126         * Added: buddy-icon-cached signal
2127           Emitted when a new buddy icon is cached.
2129 version 1.3.1 (6/9/2005):
2130         * No changes
2132 version 1.3.0 (5/10/2005):
2133         * Added: gaim_blist_schedule_save()
2134           This should be used instead of gaim_blist_sync when you
2135           want the blist.xml file to be written to disk.  There
2136           should not be many occasions when you want to do this,
2137           as the functions in the blist API that modify the buddy
2138           list will normally call it for you.
2139         * Added: OPT_PROTO_NO_NORMALIZE_CONV
2140           Tells the conversation API to not normalize screen names
2141           in conversations.  This is used by the Jabber PRPL.
2143 version 1.2.1 (4/3/2005):
2144         * No changes
2146 version 1.2.0 (3/17/2005):
2147         * You can use gaim_signal_connect_priority() and
2148           gaim_signal_connect_priority_vargs() to connect to
2149           Gaim signals with a given priority (Will Gorman)
2150         * Added: gaim_conversation_set_features
2151                  gaim_conversation_get_features
2152           These allow plugins (notable prpls) to change the
2153           formatting capabilities of an existing conversation.
2154           This comes with a new "features" field in
2155           GaimConversation (Christopher O'Brien)
2156         * Added: GAIM_CONNECTION_NO_IMAGES to GaimConectionFlags
2157            (Christopher O'Brien)
2158         * Added: GAIM_CBFLAGS_TYPING to GaimConvChatBuddyFlags
2159            (Christopher O'Brien)
2160         * Added: gaim_account_request_add which takes the same arguments as
2161         *  gaim_account_notify_added but always asks the user if they want to add
2162         *  the buddy to the buddy list
2163         * Added: An accompanying request_add GaimAccountUiOp
2165 version 1.1.4 (2/24/2005):
2166         * No changes
2168 version 1.1.3 (2/17/2005):
2169         * No changes
2171 version 1.1.2 (1/20/2005):
2172         * No changes
2174 version 1.1.1 (12/28/2004):
2175         * No changes
2177 version 1.1.0 (12/02/2004):
2178         * Added: gaim_utf8_salvage
2179         * Added: binary relocation support in prefix.h
2180                  WARNING: If your plugin uses anything inside the
2181                  #ifdef ENABLE_BINRELOC from prefix.h, it won't be
2182                  loadable on a copy of Gaim compiled without binreloc
2183                  support. In particular, watch out for the autoconf-like
2184                  macros, and accidently including them through internal.h,
2185                  which you probably shouldn't be including anyway.
2187 version 1.0.0 (09/17/2004):
2188         * Added: get_chat_name to the GaimPluginProtocolInfo struct
2189         * Changed: gaim_blist_update_buddy_presence(), presence changed to
2190                    type gboolean
2191         * Changed: the versioning scheme, and all the plugin structs
2193 version 0.82 (08/26/2004):
2194         Gaim API:
2195         * Removed: gaim_gtk_get_dispstyle(), gaim_gtk_change_text()
2196         * Removed: multi.h
2197         * Renamed: ui.h to gtkdialogs.h
2198         * Renamed: gtkinternal.h to gtkgaim.h
2199         * Renamed: show_info_dialog to gaim_gtkdialogs_info
2200         * Renamed: show_log_dialog to gaim_gtkdialogs_log
2201         * Renamed: show_warn_dialog to gaim_gtkdialogs_warn
2202         * Renamed: show_im_dialog to gaim_gtkdialogs_im
2203         * Renamed: gaim_gtkdialogs_new_im to gaim_gtkdialogs_im_with_user
2204         * Renamed: destroy_all_dialogs to gaim_gtkdialogs_destroy_all
2205         * Renamed: alias_dialog_bud to gaim_gtkdialogs_alias_buddy
2206         * Renamed: alias_dialog_contact to gaim_gtkdialogs_alias_contact
2207         * Renamed: alias_dialog_blist_chat to gaim_gtkdialogs_alias_chat
2208         * Renamed: show_confirm_del to gaim_gtkdialogs_remove_buddy
2209         * Renamed: show_confirm_del_group to gaim_gtkdialogs_remove_group
2210         * Renamed: show_confirm_del_blist_chat to gaim_gtkdialogs_remove_chat
2211         * Renamed: show_confirm_del_contact to gaim_gtkdialogs_remove_contact
2212         * Renamed: show_about to gaim_gtkdialogs_about
2213         * Added: gaim_notify_userinfo() and the associated notify_userinfo() UI op
2214                  which pass account and contact information associated with the
2215                  userinfo
2217         Buddy List API:
2218         * Changed: gaim_blist_request_add_chat(), added name parameter
2219         * Added: gaim_contact_on_account()
2220         * Added: flags parameter to the GaimBlistNode struct
2222         Conversation API:
2223         * Added: gaim_gtkconv_button_new()
2225         Protocol Plugin API: v7
2226         * Added: chat_info_defaults to the GaimPluginProtocolInfo struct
2228         Signals:
2229         * Added: conversation-updated for any update to the data associated
2230           with the conversation (topic, icon, adding to buddy list, etc.)
2232         Conversation API:
2233         * Changed: gaim_conv_chat_add_user() (added new_arrival parameter)
2235 version 0.81 (08/05/2004):
2236         Commands API:
2237         * Most functions now have a void *data argument.
2239         Blist API:
2240         * Added: gaim_buddy_get_contact_alias
2241         * Renamed: gaim_get_buddy_alias to gaim_buddy_get_alias
2242         * Renamed: gaim_get_buddy_alias_only to gaim_buddy_get_alias_only
2244         Conversation API:
2245         * Changed: gaim_conv_chat_add_user(), added flags parameter
2246         * Changed: gaim_conv_chat_add_users(), added GList of flags parameter
2247         * Changed: gaim_conv_chat_get_users(), now returns a GList of
2248           GaimConvChatBuddy's
2249         * Changed: gaim_conv_chat_set_users() now expects a GList of
2250           GaimConvChatBuddy's
2251         * Added: gaim_conv_chat_set_user_flags()
2252         * Added: gaim_conv_chat_get_user_flags()
2253         * Added: gaim_conv_chat_find_user()
2254         * Added: gaim_conv_chat_cb_new()
2255         * Added: gaim_conv_chat_cb_find()
2256         * Added: gaim_conv_chat_cb_destroy()
2257         * Added: gaim_conv_chat_cb_get_name()
2259         Conversation UI ops:
2260         * Added: chat_update_user()
2262         Signals:
2263         * Changed: chat-buddy-joining & chat-buddy-joined now include the user's flags
2264         * Changed: chat-buddy-joining & chat-buddy-leaving are now booleans, return
2265           TRUE if you don't want the join/leave to be displayed in the UI.
2266         * Added: chat-buddy-flags for when user's flags change
2267           gaim_marshal_VOID__POINTER_POINTER_POINTER_UINT_UINT (required for the new
2268           chat-buddy-flags signal)
2269         * Added: account-modified for when account settings have been changed.
2271 version 0.80 (07/15/2004):
2272         Gaim API:
2273         * Removed: PRPL numbers : gaim_account_set_protocol(),
2274           gaim_account_get_protocol(), gaim_accounts_find_with_prpl_num,
2275           gaim_prpl_num_to_id(), gaim_prpl_id_to_num(), GaimProtocol
2277         Protocol Plugin API: v6
2278         * Added: can_receive_file & send_file to the GaimPluginProtocolInfo struct
2280         Signals:
2281         * Changed "chat-invited" to also include the components hash table so
2282           plugins can use serv_join_chat when the signal is emitted.
2283         * Added "chat-topic-changed" signal plugins know when a topic is changed.
2285 version 0.79 (06/24/2004):
2286         Gaim API:
2287         * gaim_url_parse() now takes two additional parameters, which are used
2288           for returning the username and password from the URL, if they exist.
2289         * Added: has_focus UI op to GaimConversationUiOps and
2290           GaimConvWindowUiOps.
2291         * Added: gaim_conversation_has_focus() and gaim_conv_window_has_focus().
2292         * Removed: gaim_blist_save()
2294         Protocol Plugin API: v5
2295         * Changed: add_buddy, add_buddies, remove_buddy, remove_buddies,
2296           rename_group and remove_group to take GaimBuddy's and
2297           GaimGroup's consistently.
2298         * Removed: OPT_PROTO_BUDDY_ICON (replaced by icon_spec)
2299         * Added: icon_spec to the GaimPluginProtocolInfo struct
2301 version 0.78 (05/30/2004):
2302         Plugin API: v4
2303         * Added: actions - for plugins to add to the new Plugin Actions menu
2305         Loader Plugin API: v2 (no changes)
2307         Protocol Plugin API: v4
2308         * Removed: set_dir, get_dir and dir_search (not used, AIM-centric)
2309         * Removed: actions (replaced by generic plugin actions)
2311         Perl Plugin API: v2 (no changes)
2312         TCL Plugin API: (no changes)
2314         Signals:
2315         * Added: "blist-node-extended-menu" for extending Buddy, Chat and
2316                          Group right-click menus
2317         * Added: "drawing-tooltip" for plugins to allow plugins to change text
2318                          appearing in tooltips
2319         * Added: "gtkblist-created"
2320         * Added: "receiving-im-msg" and "receiving-chat-msg" (these behave
2321                           exactly like received-*-msg used to)
2322         * Added: "buddy-idle-updated" signal, for when the idle time changes.
2323         * Changed: "received-im-msg" and "received-chat-msg" no longer pass
2324                            pointers to who, message and flags, and are now void.
2325         * Removed: "drawing-menu" - it was UI sepecific and
2326                            "blist-node-extended-menu" is superior
2328 version 0.77 (04/22/2004):
2329         Loader & Protocol Plugins independantly versioned
2330         Plugin loading now checks versioning on plugins (Standard, Loader &
2331         Protocol)
2332         new GAIM_{PLUGIN,PRPL,LOADER}_API_VERSION constants
2334         Plugin API: v3
2335         * Added: prefs_info for UI independant plugin prefs
2337         Loader Plugin API: v2
2338         * Added: api_version at top of GaimPluginLoaderInfo struct
2340         Protocol Plugin API: v2
2341         * Added: api_version at top of GaimPluginProtocolInfo struct
2342         * Added: chat_menu for protocol specific extensions to the chat menu
2343         * Removed: get_away "Nada used it. Pink elephants on parade."
2344         * Removed: protocol_prefs (replaced by generic plugin prefs_info)
2346         Perl Plugin API: v2 (no changes)
2347         TCL API: (no changes)
2349         Signals:
2350         * Added: "conversation-drag-ended"
2352 version 0.76 (04/01/2004):
2353         Plugin API: v2
2354         Perl Plugin API: v2
2355         Loader Plugin API: (not versioned)
2356         Protocol Plugin API: (not versioned)
2357         * Added: protocol_prefs for protocol specific preferences
2358         * Added: reject_chat so protocols can act on chat invite rejection
2360         TCL Plugin API: (not versioned)
2361         * Changes to plugin registration to show descriptions