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