[Telepathy] Announce: telepathy-glib 0.19.1

[Guillaume Desmottes]

tarball:
http://telepathy.freedesktop.org/releases/telepathy-glib/telepathy-glib-0.19.1.tar.gz
signature:
http://telepathy.freedesktop.org/releases/telepathy-glib/telepathy-glib-0.19.1.tar.gz.asc
git: http://cgit.freedesktop.org/telepathy/telepathy-glib

Dependencies:

• Valac ≥ 0.16.0 is now required for the Vala bindings.

Deprecations:

• TpHandle reference count related APIs have been deprecated.
  - The CM-side APIs tp_handle(s)_ref/unref() and
    tp_handle(s)_client_hold/release() were already no-op since immortal
    handles.
  - The Client-side APIs tp_connection_hold/unref_handles() are not
needed with
    CMs having immortal handles. Others CM are considered legacy,
clients
    wanting to keep support for them should continue using those
deprecated
    APIs (Notably Empathy already dropped support for them since version
3.4).
  (Xavier)

• Contact attributes APIs have been deprecated. It is considered an
internal
  implementation detail for TpContact that clients doesn't need to care
about.
  tp_connection_get_contact(_list)_attributes(). (Xavier)

• tp_connection_request_handles() has been deprecated because higher
level APIs
  now make it useless. If handle_type is TP_HANDLE_TYPE_CONTACT, use
  tp_connection_dup_contact_by_id_async() instead. For channel requests,
use
  tp_account_channel_request_set_target_id() instead. (Xavier)

• tp_channel_manager_emit_new_channels() has been deprecated, emitting
multiple
  channels at once is discouraged because it makes client-side code more
  complicated for no good reason. (Jonny)

• tp_connection_parse_object_path() has been deprecated because the
connection's
  object-path is already parsed internaly and exposed via
  tp_connection_get_connection_manager_name() and
  tp_connection_get_protocol_name(). (Xavier)

• tp_account_parse_object_path() has been deprecated because the
account's
  object-path is already parsed internaly and exposed via
  tp_account_get_connection_manager() and tp_account_get_protocol().
(Xavier)

• tp_account_ensure_connection() has been deprecated. Its purpose was to
share
  a common TpConnection object between TpBaseClient and TpAccount. Now
proxy
  uniqueness is guaranteed by TpSimpleClientFactory. (Xavier)

• Struct members of TpProxy, TpConnectionManagerParam,
TpConnectionManager and
  TpBaseConnection have been sealed. In the same spirit than G_SEAL, we
  introduced _TP_SEAL to force usage of getters and setters. (Simon)

• Including individual headers is now deprecated. Only the
teleapthy-glib.h and
  telepathy-glib-dbus.h meta headers should be included in applications.
Build
  error is disabled by default and can be turned on by defining
  TP_DISABLE_SINGLE_INCLUDE. (Xavier)

• tp_list_connection_managers() has been deprecated in favor of
  tp_list_connection_managers_async() and
tp_list_connection_managers_finish().
  (Simon)

• TpConnectionManagerProtocol and all its related functions have been
deprecated
  in favor of TpProtocol. (Simon)

Enhancements:

• New TpAccountRequest object to help account creation (Jonny)

• TpSimpleClientFactory gained API to prepare TpContact objects with the
  features set on it. tp_simple_client_factory_upgrade_contacts_async()
is
  convenience API for tp_connection_upgrade_contacts_async().
  tp_simple_client_factory_ensure_contact_by_id_async() is convenience
API for
  tp_connection_dup_contact_by_id_async(). (Xavier)

• tp_simple/automatic_client_factory_new() now accept NULL TpDBusDaemon
arg.
  tp_dbus_daemon_dup() will be used internaly in that case. (Xavier)

Fixes:

• Fixed possible case where TP_CONTACT_FEATURE_AVATAR_DATA does not get
  prepared. (Xavier)