Major API changes

[Philip Van Hoof <spam pvanhoof be>]

I renamed the TnyFolderRefreshStatusCallback to TnyStatusCallback and I
added a status_callback parameter to tny_folder_get_msg_async too.

The function prototype for TnyStatusCallback was only changed in such a
way that the first argument is now a gpointer (might change to a
GObject). I might also remove this parameter (if you need it, you should
use the user_data for this, although a "GObject *sender" is often used
in higher programming languages and frameworks, like Java and .NET's
class libraries too).

Existing function pointer implementations should still work (they will
give you a compiler warning when using GCC, because the pointer type is
different -- TnyFolder vs gpointer --). The size, however, isn't (so
your implementations will 'just work').

It's of course interesting to review the occurrences in your MUA.

If you used the TnyFolderRefreshStatusCallback type name to store a
function pointer, you'll of course have to rename that. That's a trivial
change though.

If you used tny_folder_get_msg_async (this is unlikely, and the stuff
being build in in libtinymail-queues will be the recommended technique
for this), you'll of course need to change the call to include a
status_callback function pointer (else will your user_data pointer be
overwritten or invalidly used).

Complaints: the get_msg_async API change was solicited a few weeks ago.
The statuscallback's type rename wasn't solicited but this change
shouldn't affect a lot code (just the type-name rename, and the function
prototype of your function pointer implementations).


Although they need some small updates (in for example the samples), the
online docs are updated too ...

http://tinymail.org/API/libtinymail-1.0/libtinymail-tny-folder.html#tny-folder-get-msg-async
http://tinymail.org/API/libtinymail-1.0/libtinymail-tny-shared.html#TnyStatusCallback
http://tinymail.org/API/libtinymail-1.0/libtinymail-tny-folder.html#tny-folder-refresh-async


Have fun


-- 
Philip Van Hoof, software developer
home: me at pvanhoof dot be 
gnome: pvanhoof at gnome dot org 
http://www.pvanhoof.be/blog