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