| blob | 55670a912d0454429dfe95bc67574df479282092 |
1 Pidgin and Finch: The Pimpin' Penguin IM Clients That're Good for the Soul
3 Version 2.1.1 (08/20/2007):
4 libpurple:
5 Changed:
6 * PurpleAccountUiOps.request_authorize's authorize_cb and
7 deny_cb parameters now correctly have type
8 PurpleAccountRequestAuthorizationCb rather than GCallback.
9 (You'll want to change your UI's implementation's signature
10 to avoid warnings, and then remove some now-redundant casts
11 back to the proper type.)
13 version 2.1.0 (7/28/2007):
14 libpurple:
15 Added:
16 * purple-remote: added getstatus command
17 * conversation-extended-menu signal (See Doxygen docs)
18 * OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
19 slash commands are "native" to the protocol
20 * PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
21 should not be auto-linkified
22 * PurpleEventLoopUiOps.timeout_add_seconds
23 UIs can now use better scheduling for whole-second timers. For
24 example, clients based on the glib event loop can now use
25 g_timeout_add_seconds.
26 * purple_blist_node_get_type
27 * purple_conversation_do_command
28 * purple_conversation_get_extended_menu
29 * purple_core_ensure_single_instance
30 This is for UIs to use to ensure only one copy is running.
31 * purple_dbus_is_owner
32 * purple_timeout_add_seconds
33 Callers should prefer this to purple_timeout_add for timers
34 longer than 1 second away. Be aware of the rounding, though.
35 * purple_timeout_add_seconds
36 Callers should prefer this to purple_timeout_add for timers
37 longer than 1 second away. Be aware of the rounding, though.
38 * purple_xfer_get_remote_user
39 * purple_pounces_get_all_for_ui
40 * purple_prefs_get_children_names
41 * added displaying-email-notification and
42 displaying-emails-notification signals
44 Changed:
45 * The documentation of the following functions now properly
46 declares that the returned value must not be modified or
47 freed, which was always the case:
48 * purple_accounts_get_all
49 * purple_connections_get_all
50 * purple_connections_get_connecting
51 * purple_conv_chat_get_ignored
52 * purple_conv_chat_get_users
53 * purple_get_chats
54 * purple_get_conversations
55 * purple_get_ims
56 * purple_notify_user_info_get_entries
57 * The following functions now return a GList* instead of a
58 const GList*, as const is not very useful with GLists. The
59 returned value still must not be modified or freed:
60 * purple_account_get_status_types
61 * purple_mime_document_get_fields
62 * purple_mime_document_get_parts
63 * purple_mime_part_get_fields
64 * purple_request_fields_get_required
65 * purple_request_field_list_get_selected
66 * purple_request_field_list_get_items
67 * purple_status_type_get_attrs
68 * purple_presence_get_statuses
69 * purple_request_field_list_set_selected now takes a GList*
70 instead of a const GList* for items, as const is not very
71 useful with GLists. The passed list is still not modified
72 or freed.
73 * purple_presence_add_list now takes a GList* instead of a
74 const GList* for source_list, as const is not very useful with
75 GLists. The passed list is still not modified or freed.
77 Pidgin:
78 Added:
79 * gtk_imhtml_setup_entry
80 * pidgin_create_window
81 * pidgin_retrieve_user_info and pidgin_retrieve_user_info_in_chat,
82 shows immediate feedback when getting information about a user.
83 * gtk_imhtml_animation_new
84 Can be used for inserting an animated image into an IMHTML.
85 * pidgin_menu_position_func_helper
86 * pidgin_blist_get_name_markup, returns the buddy list markup
87 text for a given buddy.
88 * pidgin_blist_draw_tooltip and pidgin_blist_tooltip_destroy
89 for creating blist tooltips from outside of buddy list code
90 * pidgin_themes_remove_smiley_theme
92 Changed:
93 * pidgin_append_menu_action returns the menuitem added to the menu.
94 * pidgin_separator returns the separator added to the menu.
95 * PidginConversation has struct members to handle the new info
96 pane:
97 * infopane
98 * infopane_hbox
99 * infopane_model
100 * infopane_iter
102 Finch:
103 Added:
104 * finch_retrieve_user_info
106 libgnt:
107 Added:
108 * GntWS for workspaces
109 * gnt_tree_set_column_title
110 * GntSlider widget
111 * "completion" signal for GntEntry
112 * "terminal-refresh" signal for GntWM, with a corresponding entry
113 in GntWMClass
114 * New flags for GntTextView to decide whether to word-wrap or show
115 scrollbars (GntTextViewFlag) which can be set by
116 gnt_text_view_set_flag
117 * gnt_style_get_from_name
118 * gnt_window_present
119 * gnt_tree_set_column_width_ratio
120 * gnt_tree_set_column_resizable
121 * gnt_tree_set_column_is_right_aligned
122 * gnt_tree_set_search_function, gnt_tree_set_search_column,
123 gnt_tree_is_searching
124 * 'file-selected' signal is emited for GntFileSel
125 * gnt_style_parse_bool
126 * gnt_util_set_trigger_widget
128 Changed:
129 * gnt_tree_get_rows() now returns a GList* instead of a const
130 GList*, as const is not very useful with GLists. The
131 returned value still must not be modified or freed.
132 * Instead of keeping an 'invisible' item, the GntTreeColumns now
133 maintain 'flags' with the appropriate flags set
135 version 2.0.2 (6/14/2007):
136 Pidgin:
137 Deprecated:
138 * pidgin_dialogs_alias_contact: This will be removed in 3.0.0
139 unless there is sufficient demand to keep it.
141 version 2.0.0 (5/3/2007):
142 Please note all functions, defines, and data structures have been
143 re-namespaced to match the new names of Pidgin, Finch, and libpurple.
144 All gaim_gtk_* functions are now pidgin_*, former libgaim functions are
145 now purple_*. Please consult our doxygen documentation for a complete
146 reference.
148 The gaim-compat.h header exists to provide an API compatibility layer
149 for libpurple functions. As an API compatibility layer, it must be
150 included at compile time to be of use.
152 Changed:
153 * All the status stuff. Yay!
154 * gaim_prefs_connect_callback(), added handle parameter
155 * gtk_imhtml_toolbar now descends from GtkHBox making it easier to add your
156 own widgets to it
157 * gaim_find_conversation_with_account, added a "type" parameter
158 * gaim_gtk_prefs_labeled_spin_button, the "key" parameter is now a
159 const char* instead of just a char*
160 * gaim_gtk_prefs_labeled_entry, the "key" parameter is now a const char*
161 instead of just a char*
162 * the add_buddy perl sub. The sub now takes the account as the first
163 argument, and buddy and group as the second and third. It also adds
164 the buddy to the server-side buddy list of the given account.
165 * gaim_connection_new, gaim_account_connect and gaim_account_register no
166 longer return a GaimConnection
167 * keep_alive in GaimConnection is renamed to keepalive
168 * gaim_mkstemp, added a second argument, a boolean, of whether or not the
169 file is binary
170 * gaim_log_logger_new, rewritten
171 * gaim_conv_window_remove_conversation()'s last argument to be a
172 GaimConversation.
173 * A new blocked icon: pixmaps/status/default/blocked.png
174 * In pixmaps/status/default: extendedaway.png renamed to extended_away.png
175 * In pixmaps/status/default: na.png renamed to unavailable.png
176 * gtk_imhtml_toggle_bold(): No longer returns a value
177 * gtk_imhtml_toggle_italic(): No longer returns a value
178 * gtk_imhtml_toggle_underline(): No longer returns a value
179 * gtk_imhtml_toggle_strike(): No longer returns a value
180 * gtk_imhtml_scroll_to_end(): Added the smooth paramter
181 * gaim_log_new(), added conv parameter
182 * gaim_buddy_icon_new(), leaves a reference which the caller owns. Use
183 gaim_buddy_icon_unref() immediately if you don't want a reference (the
184 old behavior).
185 * GAIM_CONV_UNKNOWN to GAIM_CONV_TYPE_UNKNOWN.
186 * GAIM_CONV_IM to GAIM_CONV_TYPE_IM.
187 * GAIM_CONV_CHAT to GAIM_CONV_TYPE_CHAT.
188 * GAIM_CONV_MISC to GAIM_CONV_TYPE_MISC.
189 * GAIM_CONV_ANY to GAIM_CONV_TYPE_ANY.
190 * GaimConversationUiOps.write_conv, Replaced const char *who with
191 const char *name, const char *alias
192 * gaim_conv_chat_add_users(), added extra_msgs and new_arrivals (pass NULL
193 and FALSE respectively, to get the same behavior as before)
194 * chat_add_users in GaimConversationUiOps, added cbuddies and
195 new_arrivals and removed buddies.
196 * chat_rename_user in GaimConversationUiOps, added new_alias
197 * gaim_conv_chat_cb_new(), added alias. (pass NULL to get the same
198 behavior as before).
199 * GaimConversation.log became GList * GaimConversation.logs, so that a
200 conversation can have multiple logs at once
201 * gaim_conv_chat_add_user, added extra_msgs
202 * gaim_notify_userinfo, removed primary and secondary parameters
203 * GaimNotifyUiOps.notify_userinfo: removed title, primary, and
204 secondary parameters
205 * Idle timers are now added and removed in gtkidle.c in response
206 to the signed-on and signed-off signals
207 * GaimXfer->ops.read, GaimXfer->ops.write, gaim_xfer_set_read_fnc(),
208 gaim_xfer_set_write_fnc(), gaim_xfer_read(), gaim_xfer_write():
209 Changed ssize_t to gssize
210 * serv_got_im, serv_got_chat_in, serv_send_im and serv_chat_send all use
211 GaimMessageFlags instead of GaimConvImFlags / GaimConvChatFlags
212 * All core<->prpl message passing now uses html. This was previously true
213 for receiving messages, it's now also true for sending them. prpls that
214 don't support html need to gaim_unescape_html() the message.
215 * Notify API: GCallback -> GaimNotifyCloseCallback,
216 void *user_data -> gpointer user_data
217 * gaim_notify_searchresults_get_rows_count,
218 gaim_notify_searchresults_get_columns_count: return type now guint
219 * gaim_account_notify_added: No longer checks if there is a
220 GaimBuddy for the added user, that's left up to the prpls. See the
221 documentation for this function and gaim_account_request_add.
222 * gaim_accounts_reorder: new_index is now a gint instead of a size_t
223 * displaying-message signals: displaying-[im|chat]-msg and
224 displayed-[im|chat]-msg signals are emitted for all messages
225 (ie, for received messages, sent messages, system messages, error
226 messages etc.), and the signals now have
227 gaim_gtk_conversations_get_handle() for their handle.
228 * GAIM_NOTIFY_BUTTON_ADD_BUDDY to GAIM_NOTIFY_BUTTON_ADD
229 * conversation-switched: This signal has been moved from conversation to
230 the UI and the signal-handlers only receive the
231 conversation that has been switched to.
232 * GaimPluginProtocolInfo: Added offline_message
233 * GaimPluginProtocolInfo: Added whiteboard_prpl_ops
234 * GaimPluginProtocolInfo: Added media_prpl_ops
235 * GaimPluginProtocolInfo: Added "user_info" argument to tooltip_text,
236 changed the return type to void
237 * GaimPluginProtocolInfo: Added "full" argument to tooltip_text
238 * gaim_pounce_new(): Added option argument for pounce options
239 * gaim_network_listen() and gaim_network_listen_range(): Added
240 socket_type parameter to allow creation of UDP listening. Modified
241 to be asynchronous with a callback to allow for UPnP operation.
242 Returns a data structure that can be used to cancel the listen
243 attempt using gaim_network_listen_cancel()
244 * GaimPrefCallback: val is now a gconstpointer instead of a gpointer
245 * gtk_imhtml_get_current_format(): the arguments are now set to TRUE or
246 FALSE. Previously they were set to TRUE or left alone. Also, you
247 may now pass NULL if you're not interested in a specific formatting.
248 * Smiley Themes: Backslashes must be backslash-escaped.
249 * Plugins: Depedencies are now honored when unloading plugins.
250 * gaim_markup_extract_info_field(): Added format_cb parameter.
251 * gaim_markup_extract_info_field(): Changed GString parameter to a GaimNotifyUserInfo paramter.
252 * gaim_str_to_time(): Added support for parsing the MM/DD/YYYY format.
253 * gaim_plugin_action_new(): label is now const char *
254 * gaim_plugin_pref_new_with_name(): name is now const char *
255 * gaim_plugin_pref_new_with_label(): label is now const char *
256 * gaim_plugin_pref_new_with_name_and_label(): name and label are
257 now const char *
258 * gaim_plugin_pref_set_name(): name is now const char *
259 * gaim_plugin_pref_get_name(): return type is now const char *
260 * gaim_plugin_pref_set_label(): label is now const char *
261 * gaim_plugin_pref_get_label(): return type is now const char *
262 * gaim_plugin_pref_add_choice(): label is now const char *
263 * struct proto_chat_entry: label is now const char *
264 * struct proto_chat_entry: identifier is now const char *
265 * All network activity has been updated to use non-blocking sockets.
266 This means that plugins must be updated to expect such a socket from
267 gaim_proxy_connect() and gaim_network_listen*().
268 * gaim_proxy_connect(): changed to return NULL on error and a pointer
269 to a GaimProxyConnectInfo object which can be used to cancel
270 connection attempts using gaim_proxy_connect_cancel(). Also added
271 a 'handle' parameter that can be used to cancel the connection
272 attempt using gaim_proxy_connect_cancel_with_handle().
273 * gaim_gethostbyname_async(): Renamed to gaim_dnsquery_a() and
274 changed to return a pointer to a data structure that can be
275 used to cancel the pending DNS query using gaim_dnsquery_destroy()
276 * gaim_url_fetch(): Renamed to gaim_util_fetch_url() and changed
277 to return a pointer to a data structure that can be used to cancel
278 the pending HTTP request using gaim_util_fetch_url_cancel().
279 Corresponding callback has changed to accept this data structure
280 as its first argument, and to accept an error message as an
281 additional final argument.
282 * gaim_gtk_create_imhtml(): Added sw_ret() parameter
283 * gaim_account_get_log(): Added create parameter
284 * GAIM_CMD_P_VERYHIGH is now GAIM_CMD_P_VERY_HIGH
285 * gtk_imhtml_search_find(): Now wraps around to the top instead of
286 clearing the search at the end.
287 * gaim_gtkxfer_dialog_show: Can now take NULL to show (and possibly
288 create) a default gtkxfer dialog.
289 * CHAT_USERS_BUDDY_COLUMN became CHAT_USERS_WEIGHT_COLUMN, along with
290 a change in the values stored in the column.
291 * gaim_find_buddies() returns a list of all buddies in the account if name
292 is NULL.
293 * gaim_gtk_set_custom_buddy_icon() sets custom icon for a user.
294 * Hid the definition of _GaimStringref, which already had a warning to
295 avoid accessing it directly.
296 * notify_userinfo() UI op is passed a GaimNotifyUserInfo instead of a char*
297 for the user information
298 * gaim_buddy_icon_get_scale_size() and was changed to ALWAYS scale
299 the icon instead of only when icon_spec->scale_rules contains
300 GAIM_ICON_SCALE_DISPLAY. Callers should be changed to check the
301 scale_rules before calling this function.
302 * gaim_gtk_buddy_icon_get_scale_size() was changed to accept an
303 additional parameter which is used to determine what kind of
304 scaling should be done, if any.
305 * purple_request_input(), purple_request_choice(),
306 purple_request_choice_varg(), purple_request_action(),
307 purple_request_action_varg(), purple_request_fields(),
308 purple_request_yes_no(), purple_request_ok_cancel(),
309 purple_request_accept_cancel(), purple_request_file(), and
310 purple_request_folder() was changed to accept account, who, and
311 conversation parameters for associating the request with an account, a
312 buddy, or a conversation.
313 * Significant changes to the buddy icon and imgstore APIs. If you
314 were using any of it, it's best to look at the header files or
315 Doxygen documentation, but here are some significant changes:
316 purple_buddy_icon_new() now takes ownership of ("frees") icon_data
317 purple_buddy_icon_set_data(): likewise for data
318 purple_buddy_icon_set_for_user(): likewise for data
319 purple_buddy_icon_set_for_user() now takes a checksum parameter
320 purple_imgstore_add() was renamed to purple_imgstore_add_with_id()
321 which takes ownership of data
323 Removed:
324 * gaim_gtk_sound_{get,set}_mute() (replaced by the /gaim/gtk/sound/mute
325 preference)
326 * gaim_escape_html(const char *html) (use g_markup_escape_text(html, -1)
327 instead)
328 * gaim_accounts_sync, account changes are now scheduled to be saved
329 automatically
330 * gaim_connection_connect
331 * gaim_connection_disconnect
332 * gaim_connection_register
333 * gaim_accounts_auto_login
334 * gaim_find_conversation, use gaim_find_conversation_with_account instead
335 * gaim_chat_get_display_name
336 * gaim_conversation_set_history, gaim_conversation_get_history, and
337 GaimConversation->history. Use gtk_imhtml_get_markup instead.
338 * set_gaim_user_dir to gaim_util_set_user_dir
339 * create_prpl_icon to gaim_gtk_create_prpl_icon
340 * Window flashing support in the core: gaim_conv_window_flash, and flash UI
341 operation for conversations. Use signal "received-im-msg" or similar.
342 * All warning stuff from the core.
343 * gaim_gtkconv_get_dest_tab_at_xy(), instead use gaim_gtkconv_get_tab_at_xy()
344 * chat_add_user from GaimConversationUiOps: only chat_add_users is used
345 * chat_remove_user from GaimConversationUiOps: only chat_remove_users is used
346 * uc from the GaimBuddy struct
347 * gaim_sound_get_handle()
348 * gaim_debug_vargs()
349 * serv_add_buddy(); use gaim_account_add_buddy() instead
350 * serv_add_buddies(); use gaim_account_add_buddies() instead
351 * serv_change_passwd(); use gaim_account_change_password() instead
352 * serv_close()
353 * serv_finish_login()
354 * serv_login()
355 * serv_remove_buddy(); use gaim_account_remove_buddy() instead
356 * serv_remove_buddies(); use gaim_account_remove_buddies() instead
357 * serv_rename_group()
358 * serv_set_buddyicon(): use gaim_account_set_buddy_icon() instead
359 * serv_touch_idle(): use gaim_gtk_check_idle() instead
360 * GaimGtkImPane->a_virgin
361 * gaim_str_strip_cr(); use gaim_str_strip_char(str, '\r') instead
362 * gaim_find_buddys_group renamed to gaim_buddy_get_group
363 * gaim_gtkpounce_menu_build()
364 * gaim_gtkpounce_dialog_show()
365 * GaimGtkBuddyList->bpmenu
366 * GaimConvImFlags and GaimConvChatFlags; use GaimMessageFlags instead
367 * cb and user_data from the ops in GaimNotifyUiOps: This is now handled
368 by the notify API in the core.
369 * GaimConversationUiOps.updated: use the conversation-updated signal
370 * GAIM_SUBTYPE_CONV_WINDOW: windows are now only represented in the UI,
371 so GAIM_TYPE_BOXED is used for the signal types
372 * gaim_gtk_privacy_is_showable(): We do fallback privacy in the core
373 now, so this would always be TRUE now.
374 * GaimBlistNodeAction: See GaimMenuAction
375 * gaim_blist_node_action_new(); use gaim_menu_action_new() instead
376 * gaim_date()
377 * gaim_date_full(): See gaim_date_format_full()
378 * gaim_strftime(): See gaim_utf8_strftime()
379 * GAIM_MESSAGE_COLORIZE
380 * user_data from gaim_notify_searchresults_new_rows and from
381 notify_searchresults in GaimNotifyUiOps.
382 * gaim_conversation_get_send_history(), and send_history from
383 GaimConversation
384 * Removed ui_ops from GaimBuddyList. Use gaim_blist_get_ui_ops() instead
385 * GaimGtkConversation: dialogs (dialogs.search moved to GaimGtkWindow)
386 * gaim_show_xfer_dialog: Use gaim_gtk_xfer_dialog_show(NULL) instead.
387 * GaimGtkRoomlistDialog: Nothing used it outside of the file it was in.
388 * gaim_gtk_roomlist_dialog_new: use gaim_gtk_roomlist_show
389 * gaim_gtk_roomlist_dialog_new_with_account: use gaim_gtk_roomlist_show_with_account
390 * binreloc functions
392 Added:
393 * gaim_prefs_disconnect_by_handle()
394 * a password field to GaimConnection, which only persists for the
395 session (when "remember password" is false, account->password is
396 NEVER set) Use gaim_connection_get_password(GaimConnection *gc)
397 * gaim_log_common_writer, gaim_log_common_lister, gaim_log_common_sizer,
398 and gaim_log_get_log_dir to allow log formats that use standard Gaim
399 log directory to use Gaim's built-in code for these purposes.
400 * GaimLogCommonLoggerData struct for a basic logger_data struct to be
401 used with "common" logger functions.
402 * gaim_gtk_blist_node_is_contact_expanded, returns TRUE if the given
403 blist node is a buddy inside an expanded contact, or is itself an
404 expanded contact
405 * GaimLogSet struct, get_log_sets function to GaimLogLogger,
406 gaim_log_get_log_sets, gaim_log_set_compare
407 * gaim_privacy_check(), to check if a given user is allowed to send
408 messages to the specified account
409 * gtk_imhtml_clear_formatting()
410 * gtk_imhtml_delete to clear out part of a imhtml buffer
411 * gtk_imhtml_get_protocol_name()
412 * gaim_buddy_icons_get_full_path(), to get the full path of a buddy
413 icon setting
414 * CHAT_USERS_ALIAS_COLUMN, CHAT_USERS_COLOR_COLUMN,
415 CHAT_USERS_BUDDY_COLUMN to the list of columns for the chat
416 user list
417 * gaim_account_add_buddy()
418 * gaim_account_add_buddies()
419 * gaim_account_remove_buddy()
420 * gaim_account_remove_buddies()
421 * gaim_account_change_password()
422 * gaim_account_supports_offline_message()
423 * gaim_conversation_close_logs(), to force a conversation's log(s) to
424 be closed. New logs will be opened as necessary.
425 * gaim_got_protocol_handler_uri()
426 * gaim_plugin_get_id()
427 * gaim_plugin_get_name()
428 * gaim_plugin_get_version()
429 * gaim_plugin_get_summary()
430 * gaim_plugin_get_description()
431 * gaim_plugin_get_author()
432 * gaim_plugin_get_homepage()
433 * gaim_gtkconv_switch_active_conversation(GaimConversation *)
434 * gaim_str_strip_char() to strip a given character from
435 a given string
436 * gaim_util_chrreplace() to replace a given character with a
437 different character
438 * gaim_gtk_blist_toggle_visibility() to intelligently toggle the
439 visiblity of the buddy list
440 * gaim_gtk_blist_visibility_manager_add() to indicate the addition of a
441 visibility manager - see the docs for more information
442 * gaim_gtk_blist_visibility_manager_remove() to indicate the removal of
443 a visibility manager - see the docs for more information
444 * gaim_gtk_conversations_find_unseen_list() to get a list of conversations
445 with an "unseen" state >= to the specified state and other criteria
446 * gaim_gtk_conversations_fill_menu() fill a menu from list of conversations
447 * gaim_gtk_create_prpl_icon()
448 * gaim_gtk_create_prpl_icon_with_status()
449 * gaim_gtk_pounces_manager_show()
450 * gaim_gtk_pounces_manager_hide()
451 * gaim_gtk_pounce_editor_show()
452 * GAIM_POUNCE_MESSAGE_RECEIVED
453 * GaimPounceOption
454 * gaim_pounce_set_options()
455 * gaim_pounce_set_options()
456 * GAIM_STOCK_CONNECT, GAIM_STOCK_DISCONNECT
457 * GAIM_STOCK_PLUGIN
458 * gaim_account_request_add: Notifies the user that they were added to
459 someone's buddy list, and offers them the choice
460 of adding that person to their buddy list.
461 * gaim_blist_alias_contact()
462 * gaim_cipher_http_digest_calculate_session_key()
463 * gaim_cipher_http_digest_calculate_response()
464 * gaim_notify_searchresults_labeled()
465 * GAIM_NOTIFY_BUTTON_LABELED, GAIM_NOTIFY_BUTTON_INFO,
466 GAIM_NOTIFY_BUTTON_IM, GAIM_NOTIFY_BUTTON_JOIN,
467 GAIM_NOTIFY_BUTTON_INVITE
468 * stock buttons GAIM_STOCK_IM, GAIM_STOCK_INFO
469 * gaim_conversation_present()
470 * GaimConversationUiOps->present(GaimConversation *)
471 * GaimPlugin.unloadable
472 * gaim_plugin_is_unloadable()
473 * GAIM_PLUGIN_PREF_STRING_FORMAT
474 * gaim_plugin_pref_get_format_type()
475 * gaim_plugin_pref_set_format_type()
476 * GaimStringFormatType
477 * gaim_log_get_handle()
478 * gaim_log_uninit()
479 * GAIM_SUBTYPE_LOG
480 * gaim_marshal_POINTER__POINTER_POINTER
481 * gaim_utf8_ncr_encode()
482 * gaim_gtk_log_init()
483 * gaim_gtk_log_get_handle()
484 * gaim_gtk_log_uninit()
485 * gaim_util_fetch_url_request()
486 * GaimMenuAction
487 * gaim_menu_action_new()
488 * gaim_menu_action_free()
489 * GaimInfoFieldFormatCallback
490 * gaim_utf8_strftime()
491 * gaim_date_format_short()
492 * gaim_date_format_long()
493 * gaim_date_format_full()
494 * gaim_time_format()
495 * gaim_plugin_action_free()
496 * GaimRequestType: Added GAIM_REQUEST_FOLDER
497 * GaimRequestUiOps: Added request_folder
498 * gaim_request_folder()
499 * gaim_gtk_setup_screenname_autocomplete()
500 * gaim_gtk_set_cursor()
501 * gaim_gtk_clear_cursor()
502 * GAIM_MESSAGE_ACTIVE_ONLY
503 * gaim_proxy_get_setup()
504 * GaimNotifySearchResultsCallback: Added user_data.
505 * gaim_notify_searchresults: Added user_data.
506 * gaim_network_listen_cancel(): Can be used to cancel a previous
507 call to gaim_network_listen() or gaim_network_listen_range()
508 * gaim_proxy_connect_cancel(): Can be used to cancel a pending
509 gaim_proxy_connect() request
510 * gaim_proxy_connect_cancel_with_handle(): Can be used to cancel
511 a previous gaim_proxy_connect() request using a specified handle
512 * gaim_dnsquery_destroy(): Can be used to cancel a pending DNS
513 query.
514 * gaim_util_fetch_url_cancel(): Can be used to cancel a pending
515 call to gaim_util_fetch_url() or gaim_util_fetch_url_request().
516 * GaimGtkWindow: dialogs.search (previously in GaimGtkConversation)
517 * gaim_buddy_get_server_alias()
518 * gaim_conv_send_confirm()
519 * GaimConversationUiOps.send_confirm
520 * gaim_gtk_roomlist_dialog_show_with_account
521 * gaim_gtk_tree_view_search_equal_func to be used with
522 gtk_tree_view_set_search_equal_func
523 * gaim_xfer_set_bytes_sent(). Sets the offset in the file to
524 read from or write to.
525 * gaim_privacy_deny and gaim_privacy_allow
526 * gaim_gtk_blist_set_headline
527 * gaim_gtk_set_urgent
528 * GtkGaimScrollBook and its functions.
529 * purple_markup_unescape_entity()
530 * purple_markup_get_css_property()
531 * purple_group_get_name()
533 Signals - Changed: (See the Doxygen docs for details on all signals.)
534 * Signal propagation now stops after a handler returns a non-NULL value.
535 This value is now returned. Previously, all registered handlers were
536 called and the value from the last handler was used.
537 * "buddy-typing" and "buddy-typing-stopped": replaced the GaimConversation*
538 with GaimAccount*, const char *name. Also, the signal is now emitted
539 regardless of whether a conversation exists and regardless of whether
540 the user is on the buddy list.
541 * "chat-buddy-joined": added the new_arrival argument
542 * "chat-invited" handlers can now return a value to control what happens
543 to the invite (accept, reject, prompt the user).
544 * "chat-left": Emitted *after* setting chat->left to TRUE.
545 * "drawing-tooltip": the second argument is now a GString* instead of
546 a char**
547 * "drawing-tooltip": added the "full" argument
548 * "received-im-msg" and "received-chat-msg" to match, both now pass a
549 conversation pointer and flags
550 * "receiving-im-msg" and "receving-chat-msg" to match, both now pass a
551 conversation pointer and a pointer to the flags.
552 * "writing-im-msg", "wrote-im-msg", "writing-chat-msg", "wrote-chat-msg":
553 Now emitted from a difference place in the message handling code.
554 The arguments also changed.
555 * "displaying-im-msg", "displayed-im-msg", "displaying-chat-msg",
556 "displayed-chat-msg": Added "who" argument, which changes the order
557 of the existing arguments.
559 Signals - Added: (See the Doxygen docs for details on all signals.)
560 * "account-disabled"
561 * "account-status-changed"
562 * "account-alias-changed"
563 * "cipher-added"
564 * "cipher-removed"
565 * "conversation-dragging"
566 * "dbus-method-called"
567 * "dbus-introspect"
568 * "file-recv-accept"
569 * "file-recv-start"
570 * "file-recv-cancel"
571 * "file-recv-complete"
572 * "file-recv-request"
573 * "file-send-accept"
574 * "file-send-start"
575 * "file-send-cancel"
576 * "file-send-complete"
577 * "buddy-added"
578 * "buddy-removed"
579 * "blist-node-aliased"
580 * "buddy-status-changed"
581 * "buddy-idle-changed": A buddy's idle status changed.
582 * "buddy-icon-changed"
583 * "buddy-got-login-time": The login time for a buddy is now known
584 * "displaying-userinfo"
585 * "gtkblist-hiding"
586 * "gtkblist-unhiding"
587 * "log-displaying"
588 * "network-configuration-changed"
589 * "savedstatus-changed"
590 * "sendto-extended-menu"
591 * "uri-handler"
593 Signals - Removed:
594 * "account-away": replaced by account-status-changed
595 * "account-warned"
596 * "buddy-away": replaced by buddy-status-changed
597 * "buddy-back": replaced by buddy-status-changed
598 * "buddy-idle": replaced by buddy-idle-changed
599 * "buddy-unidle": replaced by buddy-idle-changed
600 * "buddy-icon-cached": replaced by buddy-icon-changed
601 * "conversation-drag-end": replaced by conversation-dragging
602 * "conversation-switching"
604 version 1.5.0 (8/11/2005):
605 * Added: gaim_xfer_conversation_write
606 Writes a messages to a conversation window with the use
607 of the associated file transfer.
609 version 1.4.0 (7/7/2005):
610 * Added: gaim_buddy_icon_uncache()
611 Deletes a cached buddy icon for a specified buddy
612 * Added: gaim_buddy_icon_get_type
613 Attempts to determine the type of a given buddy icon.
614 * Added: buddy-icon-cached signal
615 Emitted when a new buddy icon is cached.
617 version 1.3.1 (6/9/2005):
618 * No changes
620 version 1.3.0 (5/10/2005):
621 * Added: gaim_blist_schedule_save()
622 This should be used instead of gaim_blist_sync when you
623 want the blist.xml file to be written to disk. There
624 should not be many occasions when you want to do this,
625 as the functions in the blist API that modify the buddy
626 list will normally call it for you.
627 * Added: OPT_PROTO_NO_NORMALIZE_CONV
628 Tells the conversation API to not normalize screen names
629 in conversations. This is used by the Jabber PRPL.
631 version 1.2.1 (4/3/2005):
632 * No changes
634 version 1.2.0 (3/17/2005):
635 * You can use gaim_signal_connect_priority() and
636 gaim_signal_connect_priority_vargs() to connect to
637 Gaim signals with a given priority (Will Gorman)
638 * Added: gaim_conversation_set_features
639 gaim_conversation_get_features
640 These allow plugins (notable prpls) to change the
641 formatting capabilities of an existing conversation.
642 This comes with a new "features" field in
643 GaimConversation (Christopher O'Brien)
644 * Added: GAIM_CONNECTION_NO_IMAGES to GaimConectionFlags
645 (Christopher O'Brien)
646 * Added: GAIM_CBFLAGS_TYPING to GaimConvChatBuddyFlags
647 (Christopher O'Brien)
648 * Added: gaim_account_request_add which takes the same arguments as
649 * gaim_account_notify_added but always asks the user if they want to add
650 * the buddy to the buddy list
651 * Added: An accompanying request_add GaimAccountUiOp
653 version 1.1.4 (2/24/2005):
654 * No changes
656 version 1.1.3 (2/17/2005):
657 * No changes
659 version 1.1.2 (1/20/2005):
660 * No changes
662 version 1.1.1 (12/28/2004):
663 * No changes
665 version 1.1.0 (12/02/2004):
666 * Added: gaim_utf8_salvage
667 * Added: binary relocation support in prefix.h
668 WARNING: If your plugin uses anything inside the
669 #ifdef ENABLE_BINRELOC from prefix.h, it won't be
670 loadable on a copy of Gaim compiled without binreloc
671 support. In particular, watch out for the autoconf-like
672 macros, and accidently including them through internal.h,
673 which you probably shouldn't be including anyway.
675 version 1.0.0 (09/17/2004):
676 * Added: get_chat_name to the GaimPluginProtocolInfo struct
677 * Changed: gaim_blist_update_buddy_presence(), presence changed to
678 type gboolean
679 * Changed: the versioning scheme, and all the plugin structs
681 version 0.82 (08/26/2004):
682 Gaim API:
683 * Removed: gaim_gtk_get_dispstyle(), gaim_gtk_change_text()
684 * Removed: multi.h
685 * Renamed: ui.h to gtkdialogs.h
686 * Renamed: gtkinternal.h to gtkgaim.h
687 * Renamed: show_info_dialog to gaim_gtkdialogs_info
688 * Renamed: show_log_dialog to gaim_gtkdialogs_log
689 * Renamed: show_warn_dialog to gaim_gtkdialogs_warn
690 * Renamed: show_im_dialog to gaim_gtkdialogs_im
691 * Renamed: gaim_gtkdialogs_new_im to gaim_gtkdialogs_im_with_user
692 * Renamed: destroy_all_dialogs to gaim_gtkdialogs_destroy_all
693 * Renamed: alias_dialog_bud to gaim_gtkdialogs_alias_buddy
694 * Renamed: alias_dialog_contact to gaim_gtkdialogs_alias_contact
695 * Renamed: alias_dialog_blist_chat to gaim_gtkdialogs_alias_chat
696 * Renamed: show_confirm_del to gaim_gtkdialogs_remove_buddy
697 * Renamed: show_confirm_del_group to gaim_gtkdialogs_remove_group
698 * Renamed: show_confirm_del_blist_chat to gaim_gtkdialogs_remove_chat
699 * Renamed: show_confirm_del_contact to gaim_gtkdialogs_remove_contact
700 * Renamed: show_about to gaim_gtkdialogs_about
701 * Added: gaim_notify_userinfo() and the associated notify_userinfo() UI op
702 which pass account and contact information associated with the
703 userinfo
705 Buddy List API:
706 * Changed: gaim_blist_request_add_chat(), added name parameter
707 * Added: gaim_contact_on_account()
708 * Added: flags parameter to the GaimBlistNode struct
710 Conversation API:
711 * Added: gaim_gtkconv_button_new()
713 Protocol Plugin API: v7
714 * Added: chat_info_defaults to the GaimPluginProtocolInfo struct
716 Signals:
717 * Added: conversation-updated for any update to the data associated
718 with the conversation (topic, icon, adding to buddy list, etc.)
720 Conversation API:
721 * Changed: gaim_conv_chat_add_user() (added new_arrival parameter)
723 version 0.81 (08/05/2004):
724 Commands API:
725 * Most functions now have a void *data argument.
727 Blist API:
728 * Added: gaim_buddy_get_contact_alias
729 * Renamed: gaim_get_buddy_alias to gaim_buddy_get_alias
730 * Renamed: gaim_get_buddy_alias_only to gaim_buddy_get_alias_only
732 Conversation API:
733 * Changed: gaim_conv_chat_add_user(), added flags parameter
734 * Changed: gaim_conv_chat_add_users(), added GList of flags parameter
735 * Changed: gaim_conv_chat_get_users(), now returns a GList of
736 GaimConvChatBuddy's
737 * Changed: gaim_conv_chat_set_users() now expects a GList of
738 GaimConvChatBuddy's
739 * Added: gaim_conv_chat_set_user_flags()
740 * Added: gaim_conv_chat_get_user_flags()
741 * Added: gaim_conv_chat_find_user()
742 * Added: gaim_conv_chat_cb_new()
743 * Added: gaim_conv_chat_cb_find()
744 * Added: gaim_conv_chat_cb_destroy()
745 * Added: gaim_conv_chat_cb_get_name()
747 Conversation UI ops:
748 * Added: chat_update_user()
750 Signals:
751 * Changed: chat-buddy-joining & chat-buddy-joined now include the user's flags
752 * Changed: chat-buddy-joining & chat-buddy-leaving are now booleans, return
753 TRUE if you don't want the join/leave to be displayed in the UI.
754 * Added: chat-buddy-flags for when user's flags change
755 gaim_marshal_VOID__POINTER_POINTER_POINTER_UINT_UINT (required for the new
756 chat-buddy-flags signal)
757 * Added: account-modified for when account settings have been changed.
759 version 0.80 (07/15/2004):
760 Gaim API:
761 * Removed: PRPL numbers : gaim_account_set_protocol(),
762 gaim_account_get_protocol(), gaim_accounts_find_with_prpl_num,
763 gaim_prpl_num_to_id(), gaim_prpl_id_to_num(), GaimProtocol
765 Protocol Plugin API: v6
766 * Added: can_receive_file & send_file to the GaimPluginProtocolInfo struct
768 Signals:
769 * Changed "chat-invited" to also include the components hash table so
770 plugins can use serv_join_chat when the signal is emitted.
771 * Added "chat-topic-changed" signal plugins know when a topic is changed.
773 version 0.79 (06/24/2004):
774 Gaim API:
775 * gaim_url_parse() now takes two additional parameters, which are used
776 for returning the username and password from the URL, if they exist.
777 * Added: has_focus UI op to GaimConversationUiOps and
778 GaimConvWindowUiOps.
779 * Added: gaim_conversation_has_focus() and gaim_conv_window_has_focus().
780 * Removed: gaim_blist_save()
782 Protocol Plugin API: v5
783 * Changed: add_buddy, add_buddies, remove_buddy, remove_buddies,
784 rename_group and remove_group to take GaimBuddy's and
785 GaimGroup's consistently.
786 * Removed: OPT_PROTO_BUDDY_ICON (replaced by icon_spec)
787 * Added: icon_spec to the GaimPluginProtocolInfo struct
789 version 0.78 (05/30/2004):
790 Plugin API: v4
791 * Added: actions - for plugins to add to the new Plugin Actions menu
793 Loader Plugin API: v2 (no changes)
795 Protocol Plugin API: v4
796 * Removed: set_dir, get_dir and dir_search (not used, AIM-centric)
797 * Removed: actions (replaced by generic plugin actions)
799 Perl Plugin API: v2 (no changes)
800 TCL Plugin API: (no changes)
802 Signals:
803 * Added: "blist-node-extended-menu" for extending Buddy, Chat and
804 Group right-click menus
805 * Added: "drawing-tooltip" for plugins to allow plugins to change text
806 appearing in tooltips
807 * Added: "gtkblist-created"
808 * Added: "receiving-im-msg" and "receiving-chat-msg" (these behave
809 exactly like received-*-msg used to)
810 * Added: "buddy-idle-updated" signal, for when the idle time changes.
811 * Changed: "received-im-msg" and "received-chat-msg" no longer pass
812 pointers to who, message and flags, and are now void.
813 * Removed: "drawing-menu" - it was UI sepecific and
814 "blist-node-extended-menu" is superior
816 version 0.77 (04/22/2004):
817 Loader & Protocol Plugins independantly versioned
818 Plugin loading now checks versioning on plugins (Standard, Loader &
819 Protocol)
820 new GAIM_{PLUGIN,PRPL,LOADER}_API_VERSION constants
822 Plugin API: v3
823 * Added: prefs_info for UI independant plugin prefs
825 Loader Plugin API: v2
826 * Added: api_version at top of GaimPluginLoaderInfo struct
828 Protocol Plugin API: v2
829 * Added: api_version at top of GaimPluginProtocolInfo struct
830 * Added: chat_menu for protocol specific extensions to the chat menu
831 * Removed: get_away "Nada used it. Pink elephants on parade."
832 * Removed: protocol_prefs (replaced by generic plugin prefs_info)
834 Perl Plugin API: v2 (no changes)
835 TCL API: (no changes)
837 Signals:
838 * Added: "conversation-drag-ended"
840 version 0.76 (04/01/2004):
841 Plugin API: v2
842 Perl Plugin API: v2
843 Loader Plugin API: (not versioned)
844 Protocol Plugin API: (not versioned)
845 * Added: protocol_prefs for protocol specific preferences
846 * Added: reject_chat so protocols can act on chat invite rejection
848 TCL Plugin API: (not versioned)
849 * Changes to plugin registration to show descriptions