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