ANNOUNCE: folks 0.6.0

[Travis Reitter <travis reitter collabora co uk>]

libfolks 0.6.0 is now available for download from:

http://ftp.gnome.org/pub/GNOME/sources/folks/0.6/

50539da0b42564887bbce67d3a4107f3a7dbd8c6ae3b5d3a2d422b4f75a2b519
folks-0.6.0.tar.bz2

1077d232df3aea74a0352959fad8265e1064e238a56e6b99a01a35571d2aac4f
folks-0.6.0.tar.xz

libfolks 0.6.0 — Release the Kraken! 
========================================================================
Libfolks pulls together contacts from any number of accounts supported
by the libfolks backends. This release includes a number of backends,
including Telepathy, libsocialweb, Tracker, and a simple key-file
backend. We would like to include additional backends (especially
evolution-data-server), so let us know if we can help!

The 0.6.x series is API and ABI stable and corresponds to the Gnome 3.2
release. New will continue in the 0.6.x for the foreseeable future,
until we need to make further API or ABI breaks (which we don't
anticipate at this time). We will make an announcement when we
officially commit to API/ABI-stability for the project as a whole.

See the NEWS file for details on every break we made. In future
releases, we will have example programs that will be kept up-to-date
with the latest API as well.

For more information, see the Folks wiki page:
http://telepathy.freedesktop.org/wiki/Folks

Reference documentation is available here:
http://telepathy.freedesktop.org/doc/folks/
http://telepathy.freedesktop.org/doc/folks-eds/
http://telepathy.freedesktop.org/doc/folks-libsocialweb/
http://telepathy.freedesktop.org/doc/folks-telepathy/

Overview of changes from libfolks 0.5.2 to libfolks 0.6.0
=========================================================

Bugs fixed:
* Bug 649925 — expose SocialWebClient.Contact in Swf.Persona
* Bug 646244 — Incomplete logic to handle attribute updates in
  Folks.Individual
* Bug 652463 — Tidy up CLEANFILES
* Bug 652434 — Add ability to run any tests through gdb
* Bug 648071 — Add support for presence status from Telepathy
* Bug 652472 — Handle failure in getting the logger service better
* Bug 629716 — Migrate Folks to GDBus
* Bug 652660 — Make Individual.id more stable and well-defined
* Bug 652449 — Folks.Individual's property getters should be read only
* Bug 653325 — Build system does not complain if trying to build docs
  without vala-doc installed
* Bug 653746 — mismatch between hash and equals in Note
* Bug 638281 — Add an EDS backend
* Bug 654509 — Folks master not building
* Bug 652048 — Make nickname writable
* Bug 652425 — Failure codes for removing personas needed in
  PersonaStoreError
* Bug 645549 — Add a way to get the individual from a persona
* Bug 650422 — Add API for easily checking whether details are writeable
* Bug 655019 — Don't notify twice for nickname changes
* Bug 650414 — Need better APIs to handle image data
* Bug 652643 — Add PersonaStore cache
* Bug 655510 — Make truly-writeable *Details property setters public
* Bug 654907 — The writable store shouldn't be set by type_id
* Bug 655745 — Implement read/write support for gender property
* Bug 649296 — Folks backend files shouldn't begin with "lib"
* Bug 652657 — Allow writing to properties of all personas 
* Bug 655008 — Tidy up error handling in eds backend
* Bug 653619 — Add company details
* Bug 653679 — Change PostalAddressDetails.postal_addresses to support
  vCard-like arbitrary parameters
* Bug 653680 — Change ImDetails.im_addresses to support vCard-like
  arbitrary parameters 
* Bug 655917 — Rebase EmailDetails.email_addresses upon an
  AbstractFieldDetails-derived class
* Bug 655374 — Un-break avatar tests
* Bug 655919 — Rebase NoteDetails.notes upon an
AbstractFieldDetails-derived
  class
* Bug 655920 — Rebase PhoneDetails.numbers upon an
AbstractFieldDetails-derived
  class
* Bug 653682 — Change WebServiceDetails.web_service_addresses to support
  vCard-like arbitrary parameters
* Bug 655921 — Change RoleDetails.roles to support vCard-like arbitrary
  parameters
* Bug 655922 — Rebase UrlDetails.urls upon an
AbstractFieldDetails-derived class
* Bug 648818 — Support the EDS backend being a primary
* Bug 655609 — Implement setter for URLs

API changes:
* Swf.Persona retains and exposes its libsocialweb Contact
* Add a PresenceDetails.presence_status property
* Make NameDetails.nickname settable
* Drop AliasDetails support from Trf.Persona
* Add PersonaStoreError.PERMISSION_DENIED and
PersonaStoreError.REMOVE_FAILED
* Change the error domain of PersonaStore.remove_persona() from
  GLib.Error to Folks.PersonaStoreError
* Add a Persona.individual property
* Add a Persona.writeable_properties property and implement it in all
  the Persona subclasses
* Make BirthdayDetails.calendar_event_id nullable
* Make Folks.Utils public and add Gee structure equality functions
* AvatarDetails.avatar is now of type LoadableIcon?
* Add AvatarCache class
* Add ObjectCache class
* Remove leaked internal PotentialMatch.result_to_string() method
* Add RoleDetails:role property
* Rebase FieldDetails upon AbstractFieldDetails (requiring the use of
  the equivalent AbstractFieldDetails functions in place of the
  FieldDetails ones).
* Add AbstractFieldDetails.equal() and hash() for better matching on
  structures which will store derived objects.
* Add parameters as an optional argument for the FieldDetails
  constructor
* Use PostalAddressFieldDetails for
  PostalAddressDetails.postal_addresses
* Remove PostalAddress.types (obsoleted by
  PostalAddressFieldDetails.parameters)
* Add and use ImFieldDetails for ImDetails.im_addresses
* Add and use EmailFieldDetails for EmailFieldDetails.email_addresses
* Add and use NoteFieldDetails for NoteFieldDetails.notes
* Remove Note class (obsoleted by NoteFieldDetails)
* Add and use PhoneFieldDetails for PhoneFieldDetails.phone_numbers
* Remove all PhoneDetails functions (obsoleted by PhoneFieldDetails)
* Add and use WebServiceFieldDetails for
  WebServiceFieldDetails.web_service_addresses
* Use RoleFieldDetails for RoleDetails.roles
* Use UrlFieldDetails for UrlDetails.urls

Dependencies
============
libfolks and depend upon core GNOME libraries (GLib, GIO, etc.), as well
as the recent releases of Vala and gobject-introspection.

The Telepathy backend also requires a recent release of telepathy-glib,
built to include its Vala bindings.

The EDS backend also requires a recent release of evolution-data-server,
built to include its Vala bindings.

The Tracker backend requires a recent version of Tracker.

The Libsocialweb backend requires a recent version of libsocialweb,
built to include the Vala bindings.

Contributing/Contact
====================
For any questions, comments, feature proposals, etc., please refer to
the Telepathy mailing list or #telepathy on Freenode.
For bug reports, please file them with the GNOME Bugzilla module "folks"