Major API changes
- From: Philip Van Hoof <spam pvanhoof be>
- To: tinymail-devel-list gnome org
- Cc: Dirk-Jan Binnema <Dirk-Jan Binnema nokia com>
- Subject: Major API changes
- Date: Sun, 22 Apr 2007 14:43:11 +0200
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
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]