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