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