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