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