[Telepathy] Announce: telepathy-glib 0.19.0

[Xavier Claessens]

The “Aggressive deprecation” release.

This is the first release in the 0.19.x development series.

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

Dependencies:

• GLib ≥ 2.32, as released with GNOME 3.4, is now required.

Deprecations:

• Deprecations are now versioned. telepathy-glib users can define
  TP_VERSION_MIN_REQUIRED and/or TP_VERSION_MAX_ALLOWED, which work like
the
  corresponding macros in GLib 2.32. (Simon)

• All TpChannel APIs using contact TpHandle have been deprecated in
favor of
  their TpContact variants. Note that replacement APIs are only
guaranteed to
  work with Connection Managers implementing spec >= 0.23.4. Any CMs
using
  telepathy-glib's TpGroupMixin for implementing the channel's group
iface
  are fine. (Xavier)

• TpTextMixin is (officially) deprecated, use TpMessageMixin. (Xavier)

• TpIntsetIter is deprecated, use TpIntsetFastIter. The typedefs
  TpIntSetIter and TpIntSetFastIter are also deprecated. (Simon)

• TP_ERRORS has officially been deprecated since 0.11; it now produces
  deprecation warnings too. (Simon)

• Reimplementation of the RequestHandles method is deprecated. (Simon)

• tp_connection_get_contacts_by_id is deprecated and replaced by
  tp_connection_dup_contact_by_id_async, for proper GAsyncResult API,
and is
  now for single identifier to simplify most common use case.
  (fd.o #27687 and #30874, Xavier)

• tp_connection_get_contacts_by_handle() is deprecated with no
replacement. It
  is deprecated to create a TpContact without knowing both its id and
handle.
  (fd.o #27687 and #30874, Xavier)

• tp_connection_upgrade_contacts is deprecated and replaced by
  tp_connection_upgrade_contacts_async, for proper GAsyncResult API.
Note that
  the connection must implement the Contacts interface to use this new
API.
  (fd.o #27687 and #30874, Xavier)

• TP_CHANNEL_FEATURE_CHAT_STATES and its corresponding APIs are
deprecated and
  replaced by similar API on TpTextChannel.

Enhancements:

• <telepathy-glib/telepathy-glib.h> now includes all non-generated code
  except proxy-subclass.h. Please use it instead of individual headers -
  direct inclusion of most individual headers will become an error in
  future versions, as was done for GLib. (Simon)

• A new meta-header, <telepathy-glib/telepathy-glib-dbus.h>, now
includes
  all generated code. Please include it in any file that uses tp_svc_*,
  tp_cli_*, TP_IFACE_*, TP_HASH_TYPE_*, TP_STRUCT_TYPE_* or
TP_ARRAY_TYPE_*.
  In telepathy-glib 1.0, it will become a separate pkg-config module.
(Simon)

• Replace --disable-coding-style-checks and --disable-doc-checks with
  --disable-fatal-warnings. In addition to what the removed options did,
  it changes the default for --disable-Werror and turns off
  g-ir-scanner warnings. In future releases, it might control additional
  "warnings are treated as errors" options. Developers can also use
  --enable-fatal-warnings to force all of these on, even in official
  releases. (Simon)

• Add TpRoomList and TpRoomInfo (fd.o #30338, Guillaume)

• Add TpDebugClient (fd.o #23344; Will, Guillaume)

• Add tp_account_channel_request_new_text(),
  tp_account_channel_request_new_audio_call(),
  tp_account_channel_request_set_target_contact() etc., which do not
require
  the caller to know D-Bus property names (fd.o #48780, Simon)

• Add tp_connection_dup_detailed_error_vardict(),
  tp_base_connection_disconnect_with_dbus_error_vardict(),
  tp_connection_manager_param_dup_default_variant(),
  tp_capabilities_dup_channel_classes_variant() which use/return
GVariants
  instead of dbus-glib parameterized types (Simon, Guillaume)

• Add a simple PyGtk3 dialler to the examples, and optionally install
  the Python examples as well as the C ones (fd.o #48504, Simon)

• Add tp_contact_get_account() (Xavier)

• Improve documentation (Jonny, Simon, Xavier)

• Add "clean-for-new-branch" Makefile target which is more thorough than
  clean, but less thorough than distclean (in particular, it doesn't
  forget your ./configure options) (Simon)

• Add TpTLSCertificate, a TpProxy subclass representing a TLS
  certificate (fdo #30460, Guillaume)

• TpMessageMixin now has helpers to implement the ChatState interface.

Fixes:

• Make it safe to hold refs to a remaining GAsyncResult after returning
  to the main loop (fd.o #45554, Simon)

• When a TpProxy method call returns, which can occasionally be
synchronous,
  use an idle to finish the corresponding GAsyncResult (fd.o #45514,
Simon)

• Add TP_NUM_DBUS_ERRORS (etc.) to supersede NUM_TP_DBUS_ERRORS (etc.)
  (fd.o #46470, Simon)

• Make several methods returning a GStrv introspectable (fd.o #46471,
Simon)

• Retry preparation of features that depended on a missing connection
  interface after the connection connects, in the hope that the
interface has
  now become available (fd.o #42981, Guillaume)

• Interpret capabilities more strictly, avoiding falsely saying we
support
  channel requests with fixed properties we don't understand (Xavier)