ChangeLog.API

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

mercurial