changeset 18060:37a0a0f5122c

Document the API changes from the constification and DBus list commits, and restructure and re-sort the 2.1.0 items.

--- a/ChangeLog.API	Thu Jun 07 04:25:54 2007 +0000
+++ b/ChangeLog.API	Thu Jun 07 04:26:57 2007 +0000
@@ -1,44 +1,71 @@
 Pidgin and Finch: The Pimpin' Penguin IM Clients That're Good for the Soul
 
 version 2.1.0 (??/??/????):
-	Added:
-	* purple-remote: added getstatus command
-	* OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
-	  slash commands are "native" to the protocol
-	* PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
-	  should not be auto-linkified
-	* PurpleEventLoopUiOps.timeout_add_seconds
-	    UIs can now use better scheduling for whole-second timers.  For
-	    example, clients based on the glib event loop can now use
-	    g_timeout_add_seconds().
-	* pidgin_create_window()
-	* purple_core_ensure_single_instance()
-	    This is for UIs to use to ensure only one copy is running.
-	* purple_dbus_is_owner()
-	* purple_image_data_calculate_filename()
-	* purple_timeout_add_seconds()
-	    Callers should prefer this to purple_timeout_add() for timers
-	    longer than 1 second away.  Be aware of the rounding, though.
-	* purple_timeout_add_seconds()
-	    Callers should prefer this to purple_timeout_add() for timers
-	    longer than 1 second away.  Be aware of the rounding, though.
-	* purple_conversation_get_extended_menu
-	* purple_conversation_do_command
-	* pidgin_retrieve_user_info, shows immediate feedback when getting
-	  information about a user.
-	* gtk_imhtml_setup_entry
-	* purple_xfer_get_remote_user
-	* purple_blist_node_get_type
+	libpurple:
+		Added:
+		* purple-remote: added getstatus command
+		* conversation-extended-menu signal (See Doxygen docs)
+		* OPT_PROTO_SLASH_COMMANDS_NATIVE protocol option to indicate that
+		  slash commands are "native" to the protocol
+		* PURPLE_MESSAGE_NO_LINKIFY message flag to indicate that the message
+		  should not be auto-linkified
+		* PurpleEventLoopUiOps.timeout_add_seconds
+		    UIs can now use better scheduling for whole-second timers.  For
+		    example, clients based on the glib event loop can now use
+		    g_timeout_add_seconds.
+		* gtk_imhtml_setup_entry
+		* pidgin_create_window
+		* purple_blist_node_get_type
+		* purple_conversation_do_command
+		* purple_conversation_get_extended_menu
+		* purple_core_ensure_single_instance
+		    This is for UIs to use to ensure only one copy is running.
+		* purple_dbus_is_owner
+		* purple_dbusify_const_GList
+		* purple_dbusify_const_GSList
+		* purple_const_GList_to_array
+		* purple_const_GSList_to_array
+		* purple_image_data_calculate_filename
+		* pidgin_retrieve_user_info, shows immediate feedback when getting
+		  information about a user.
+		* purple_timeout_add_seconds
+		    Callers should prefer this to purple_timeout_add for timers
+		    longer than 1 second away.  Be aware of the rounding, though.
+		* purple_timeout_add_seconds
+		    Callers should prefer this to purple_timeout_add for timers
+		    longer than 1 second away.  Be aware of the rounding, though.
+		* purple_xfer_get_remote_user
 
-	Changed:
-	* pidgin_separator returns the separator added to the menu.
-	* pidgin_append_menu_action returns the menuitem added to the menu.
+		Changed:
+		* Mark some return types const:
+			* purple_accounts_get_all
+			* purple_connections_get_all
+			* purple_connections_get_connecting
+			* purple_conv_chat_get_ignored
+			* purple_conv_chat_get_users
+			* purple_get_chats
+			* purple_get_conversations
+			* purple_get_ims
+			* purple_notify_user_info_get_entries
 
-	Signals - Added: (See the Doxygen docs for details on all signals.)
-	* "conversation-extended-menu"
+		Deprecated:
+		* purple_dbusify_GList:  Use purple_dbusify_const_GList (and
+		  g_list_free if needed) if depending on 2.1.0 is okay.
+		* purple_dbusify_GSList:  Use purple_dbusify_const_GSList (and
+		  g_slist_free if needed) if depending on 2.1.0 is okay..
+		* purple_GList_to_array:  Use purple_const_GList_to_array (and
+		  g_list_free if needed) if depending on 2.1.0 is okay..
+		* purple_GSList_to_array:  Use purple_const_GSList_to_array (and
+		  g_slist_free if needed) if depending on 2.1.0 is okay..
 
-	Finch - Added:
-	* finch_retrieve_user_info
+	Pidgin:
+		Changed:
+		* pidgin_append_menu_action returns the menuitem added to the menu.
+		* pidgin_separator returns the separator added to the menu.
+
+	Finch:
+		Added:
+		* finch_retrieve_user_info
 
 version 2.0.0 (5/3/2007):
 	Please note all functions, defines, and data structures have been