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