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