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