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