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