[sugar] Deprecated methods in Tubes API are about to go away

[Simon McVittie]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Before FRS/1.0 we plan to resynchronize with upstream versions
of the Telepathy connection managers (#3937). This means getting rid of some
methods left over from previous versions of the Telepathy specification, which
were deprecated before Trial-3, but were still provided in Trial-3
releases for compatibility.

If you're using any of the following methods on the Tubes channel (grep your
source tree if in doubt), you need to stop doing so:

* GetDBusServerAddress
* AcceptTube
* OfferTube

As of shortly before Trial-3 code freeze, nothing in jhbuild used these
methods (Guillaume and Morgan updated everything we could find the new API),
and grep doesn't find them in a current jhbuild either, but non-jhbuild
activities might still be using them.

Porting instructions:

Old: GetDBusServerAddress(tube_id: u) -> dbus_address: s
New: GetDBusTubeAddress(tube_id: u) -> dbus_address: s

Old: AcceptTube(tube_id: u) -> nothing
New: AcceptDBusTube(tube_id: u) -> dbus_address: s
  (the new method returns the same thing as GetDBusTubeAddress - so
  you can probably save a D-Bus round trip)

Old: OfferTube(TUBE_TYPE_DBUS, service: s, params: a{sv}) -> tube_id: u
New: OfferDBusTube(service: s, params: a{sv}) -> tube_id: u

Regards,
	Simon
- -- 
Simon McVittie, Collabora Ltd.: http://www.collabora.co.uk/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: OpenPGP key: http://www.pseudorandom.co.uk/2003/contact/ or pgp.net

iD8DBQFG/UF9WSc8zVUw7HYRAm7MAJ4tmKI7ZhQC7SFORtfpaTGXDkFOpwCeOlV3
VAEfnjDO0MnTuS1xoEXW6QM=
=3vHP
-----END PGP SIGNATURE-----