-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 As a follow-up to the telepathy-glib 0.7.1 release, here's libtelepathy 0.3.2. This release adds API to TpChan and TpConn to convert to and from telepathy-glib's TpChannel and TpConnection objects, to help with migration to the new library.
Tarball: http://telepathy.freedesktop.org/releases/libtelepathy/libtelepathy-0.3.2.tar.gz Signature: http://telepathy.freedesktop.org/releases/libtelepathy/libtelepathy-0.3.2.tar.gz.asc Development branch in Darcs: http://darcs.collabora.co.uk/darcs/telepathy/libtelepathy Darcs tag: "libtelepathy 0.3.2" Here's a quick guide to: Porting from libtelepathy to telepathy-glib =========================================== The good news is that everything in telepathy-glib is documented, and there are examples in the source tarball for a lot of it too. 1. Migrate constants etc. - ------------------------- For these you need to depend on telepathy-glib 0.7.0 and libtelepathy 0.3.1. You can make a good start by using libtelepathy 0.3.1 and getting your project to compile with -DLIBTELEPATHY_DISABLE_DEPRECATED. tp_get_bus() is now in <telepathy-glib/dbus.h>. For most uses, you can remove <libtelepathy/tp-helpers.h>. Constants are now in <telepathy-glib/enums.h> and string interface names are in <telepathy-glib/interfaces.h>. Instead of the deprecated TELEPATHY_*_QUARK use TP_IFACE_QUARK_*. Enumerations are now Tp*, not Telepathy*. 2. Migrate objects - ------------------ For these you need to depend on telepathy-glib 0.7.1 and libtelepathy 0.3.2. TpConnection replaces TpConn, and TpChannel replaces TpChan. However, in general your app will need to work with both for a while, while you migrate it (or because libmissioncontrol still uses the libtelepathy API exclusively). Every libtelepathy TpConn created with the existing constructors now creates a telepathy-glib TpConnection automatically. You can retrieve the TpConnection with tp_conn_dup_connection(), and you can go from a TpConnection to a TpConn with tp_conn_new_from_connection(). Similarly, tp_chan_dup_channel() creates a telepathy-glib TpChannel from a telepathy-glib TpConnection and a libtelepathy TpChan (the TpConnection is needed for the TpChannel constructor, to get the invalidation logic right), and tp_chan_new_from_channel() creates a TpChan from a TpChannel. TpConnMgr is replaced by TpConnectionManager - there's no migration API for those though, since things like libmissioncontrol seem unlikely to have TpConnMgr in their API. The auto-generated dbus-glib API from <libtelepathy/*-gen.h> has been replaced by different auto-generated API. For each D-Bus method, there are now two C functions: tp_cli_something_call_something() makes an asynchronous call and calls a callback. tp_cli_something_run_something() does basically the same, but re-enters the main loop (just like gtk_dialog_run), so it has all the advantages and disadvantages that implies. For signals, the signal-connecting function has a different signature, but is basically similar. As well as the familiar user_data argument, the asynchronous call API and the signal-connecting API take a GObject * argument called weak_object. The proxy machinery will take a weak reference to this object, and will automatically cancel the call or remove the signal connection when the object goes away. This innovation was borrowed from telepathy-gabble - in practice, it means that you rarely need to disconnect from a D-Bus signal or cancel a pending call explicitly. - ----- Detailed Darcs changes follow. Regards, Simon Mon Feb 4 17:53:20 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> tagged libtelepathy 0.3.2 Mon Feb 4 17:28:23 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * Bump version to 0.3.2 (libtool c:r:a = 9:0:7) and telepathy-glib dep to 0.7.1 Mon Feb 4 17:28:11 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * Remove xml/modified directory from version control Fri Feb 1 15:01:58 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * Require telepathy-glib >= 0.7.0.1 Fri Feb 1 14:58:24 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * _tp_conn_new: call GetStatus() synchronously if necessary, preserving old semantics Fri Feb 1 13:49:07 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * TpConn: implement in terms of TpConnection Fri Feb 1 13:45:03 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * Document tp_connmgr_list_cms as being replaced by tp_list_connection_managers Fri Feb 1 11:28:31 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * TpChan: refactor interface-adding to avoid unnecessary D-Bus calls Fri Feb 1 11:05:05 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * tp_chan_local_set_interfaces: minor style fix Fri Feb 1 11:03:46 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * TpChan: add tp_chan_dup_channel, tp_chan_new_from_channel Thu Jan 31 16:39:05 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * TpChan: add tp_chan_new_from_channel() Thu Jan 31 16:38:43 GMT 2008 Simon McVittie <[EMAIL PROTECTED]> * src/Makefile.am: avoid confusing vim quickfix (:make) Wed Nov 28 01:50:04 GMT 2007 Robert McQueen <[EMAIL PROTECTED]> * correct the LGPL 2.1 boilerplate (s/Library/Lesser/ and update FSF address) Fri Dec 14 14:35:34 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * Add optional compiler and linker optimization control, and code coverage Fri Dec 14 14:32:46 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * Add compiler.m4, linker.m4 (from libgfshare via telepathy-glib) Thu Dec 13 14:33:27 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * TpChan, TpConn: use G_DEFINE_TYPE Thu Dec 13 12:00:30 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * TpConn: rename parent_class to tp_conn_parent_class for compatibility with G_DEFINE_TYPE Thu Dec 13 11:59:50 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * TpChan: rename parent_class to tp_chan_parent_class for compatibility with G_DEFINE_TYPE Tue Dec 4 14:27:47 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * Link dummy executables in check-compat against telepathy-glib etc. (actually dbus-glib is all that's needed) - fixes compilation without optimizations, fd.o #13484 Thu Nov 22 20:04:20 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> * Development version 0.3.1.1 Thu Nov 22 19:59:26 GMT 2007 Simon McVittie <[EMAIL PROTECTED]> tagged libtelepathy 0.3.1 -----BEGIN PGP SIGNATURE----- iD8DBQFHp2ANWSc8zVUw7HYRAiH6AKCnb1JLCj7d5IWZPAWua9+9rSpJ3QCghktB xhNFN1Io8ab57uCpLZ5iWPU= =Qu43 -----END PGP SIGNATURE----- _______________________________________________ Telepathy mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/telepathy
