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