Post-release version bump.

Release Folks 0.5.1.

Generate backend library headers in folks/ subdirs.

This is to allow in-tree building, since we changed the includedir, which
makes the vapi files include headers as <folks/header.h>. Outputting our
headers in a folks/ subdir works around this issue by making the
backend/*/lib dir match the expected includedir layout.

Don't depend upon removed LinkedHashSet stamp file.

Strip tab characters from valadocs to unbreak doc building.

Properly distribute the typelib file.

Distribute Folks-*.gir and Folks-*.typelib

Allow generated source files to exist after distcleancheck.

It turns out to be nearly impossible to satisfy a standard distcleancheck
with Vala and its automake support. This is specifically a work-around
because there doesn't seem to be any obvious way to satisfy these
requirements:

  * the release tarball can be built without gobject-introspection, valac,
    or vapigen

  * it's safe to run "make distclean" in the release tarball without
    suddenly requiring the tools listed above (due to generated files
    being removed)

  * "make distcheck" doesn't fail its "distcleancheck" phase due to the
    following files remaining after distclean:

    - tests/lib/telepathy/contactlist/tp-test-contactlist.gir
    - tests/lib/telepathy/contactlist/tp-test-contactlist.vapi
    - backends/telepathy/lib/tp-lowlevel.gir
    - backends/telepathy/lib/tp-lowlevel.vapi

We've hit this last issue multiple times, and no fix seems to stick. So
stripping out this check seems to be the best option (until we can
remove the Vala/GObject-Introspection-free build requirement, when
they've stabilized more and we don't depend upon the latest versions which
may not be in all the major distros).

Allow the types argument for PostalAddress() to be null.

Bug 649088 — Combining contacts doesn't work with german Umlauts

Fix normalisation of Jabber IDs to use the correct Unicode normalisation mode
as described in RFC 3920, §A.4. Closes: bgo#649088

Ensure includes are done with <folks/*.h>

This changes all pc files to not include -I$incdir/folks and fixes
the vapi files to add the folks/ part to the includes.

https://bugzilla.gnome.org/show_bug.cgi?id=649790

Add a “debug” command to folks-inspect to print status information

When executed, it simply calls Folks.Debug.emit_print_status().

Closes: bgo#648533

Allow printing out status information at runtime

When Folks.Debug.print-status is emitted, BackendStore, IndividualAggregator
and Tpf.PersonaStore will now print out their status, including a list
of all the loaded backends, persona stores, aggregated individuals and their
personas.

Folks.Debug.print-status could be emitted as a result of the client process
receiving SIGUSR2, for example.

Helps: bgo#648533

Add debug printing and formatting methods to Debug

This includes indentation and output colouring support.

Helps: bgo#648533

Allow the singleton Debug instance to be retrieved without setting its flags

Helps: bgo#648533

Allow enabling/disabling output of debug messages at runtime

Helps: bgo#648533

Make Debug public and restrict it to being a singleton

Also add some API documentation to its newly-public members and make it
thread-safe.

Bug 648767 — Return read-only views of Sets and Maps where possible

This prevents clients from messing up libfolks' state by modifying Sets or
Maps returned to them by libfolks when those Sets or Maps are just references
to the ones used internally by libfolks, as is the case with many
properties.

Closes: bgo#648767

Tidy up signal disconnections in IndividualAggregator

Closes: bgo#645186

Tidy up channel signal disconnections in Tpf.PersonaStore

Helps: bgo#645186

Add a missing signal disconnection to Tr.Backend

Helps: bgo#645186

Add a missing signal disconnection to Tp.Backend

Helps: bgo#645186

Add a missing signal disconnection to Kf.Backend

Helps: bgo#645186

Fix a potential crash in Swf.PersonaStore on destruction before preparation

If a Swf.PersonaStore is finalised before .prepare() is called, its
_contact_view member will be null, so it shouldn't try and disconnect from
signals from it.

Add GObject Introspection Support

Closes: bgo#648161

Add a NEWS entry for fixing bgo#640092.

Change PostalAddress.types to be a Set<string>

Helps: bgo#640092

Change PotentialMatch.known_email_aliases to be of type Set<string>

Helps: bgo#640092

Change RoleDetails.roles to be of type Set<Role>

Helps: bgo#640092

Change NoteDetails.notes to be of type Set<Note>

Helps: bgo#640092

Change LocalIdDetails.local_ids to be of type Set<string>

Helps: bgo#640092

Change PersonaStore.personas to be a Map<string, Persona>

This helps in our quest to get rid of HashTable.

Helps: bgo#640092

Change IndividualAggregator.individuals to be a Map<string, Individual>

This helps in our quest to get rid of HashTable.

Helps: bgo#640092

Change IndividualAggregator.get_[all_]potential_matches() to return a Map

We don't want to expose the fact that we're using a *hash* map internally.

Helps: bgo#640092

Change IndividualAggregator.link_personas() to take a Set<Persona>

Helps: bgo#640092

Port IndividualAggregator.individuals_changed to use Set<Individual>

Helps: bgo#640092

Fix a race condition in Tpf.PersonaStore

The /IndividualRetrieval/aggregator:add test can execute multiple calls to
Tpf.PersonaStore.add_persona_from_details() with the same contact ID
simultaneously. Since the change to use sets, the fact that only one
of the adds is succeeding is no longer hidden by our use of GLib.List.

This commit fixes the error handling in
Tpf.PersonaStore.add_persona_from_details() to be more resilient to the
contact already existing.

Helps: bgo#640092

Remove unused code from Tpf.PersonaStore

Port PersonaStore.personas_changed to Set<Persona>

Helps: bgo#640092

Port Individual.personas_changed to use Set<Persona>

Helps: bgo#640092

Port Individual.personas to be a Set<Persona>

This is a major user of GLib.List, and porting it should make porting a lot
of other stuff a lot easier.

Helps: bgo#640092

Convert the internal store of Personas in Individual to use HashSet

This converts the private variables in Individual which store its set of
Personas to use a single HashSet instead of a separate GLib.List and HashSet.

This won't compile, but making all the necessary adjustments to
Individual.personas to make it compile would've made the commit too complex
to review. The next commit will update Individual.personas.

Helps: bgo#640092

Remove use of GLib.List in public BackendStore API.

Helps bgo#640092 - Folks should minimize use of GLib.List (including its public
API)

Use just a HashSet in IndividualAggregator._add_personas()

Remove use of GLib.List. Helps: bgo#640092

Change UrlDetails.urls to be a Set<FieldDetails>

Helps: bgo#640092

Change PhoneDetails.phone_numbers to be a Set<FieldDetails>

Helps: bgo#640092

Change EmailDetails.email_addresses to be a Set<FieldDetails>

Helps: bgo#640092

Change PostalAddressDetails.postal_addresses to be a Set<PostalAddress>

Helps: bgo#640092

Change FieldDetails.parameters to be a MultiMap<string, string>

Helps: bgo#640092

Change GroupDetails.groups to be a Set<string>

Helps: bgo#640092

Change Backend.persona_stores to be a Map<string, PersonaStore>

Helps: bgo#640092

Remove LinkedHashSet in favour of Gee.HashSet

Helps: bgo#640092

Change WebServiceDetails.…addresses to be a MultiMap<string, string>

Helps: bgo#640092

Change ImDetails.im_addresses to be a MultiMap<string, string>

Helps: bgo#640092

Add navigation tests for LinkedHashSet.Iterator

Helps: bgo#645684

Implement an Iterator for LinkedHashSet

In order to ensure that calling Iterator.remove() on an iterator returned by
LinkedHashSet.iterator() actually removes the item from both the linked list
and hash set in the LinkedHashSet, we have to subclass Iterator ourselves.

This means that all the LinkedHashSet tests pass once more.

Closes: bgo#645684

Add stamping to LinkedHashSet

Since we don't have access to the stamps in the LinkedHashSet's linked list
or hash set, we have to maintain our own. This is necessary for implementing
our own Iterator. (See next commit.)

Helps: bgo#645684

Remove implementation of LinkedHashSet.list_iterator()

The extra methods provided by ListIterator are all incompatible with the
set qualities of LinkedHashSet, and would allow duplicate entries to be
introduced into the set.

LinkedHashSet.iterator() continues to return an iterator which uses the
links in LinkedHashSet to provide fast iteration.

Helps: bgo#645684

Add tests for LinkedHashSet.iterator()

Helps: bgo#645684

Don't remove the wrong Individuals from IndividualAggregator

In IndividualAggregator._individual_removed_cb(), don't remove the individual
from IndividualAggregator.individuals unless it is actually the individual
which is emitting the "removed" signal.

Closes: bgo#647121

Fix Tpf.Persona to use its store's ID in persona UIDs

It was previously (incorrectly) not using the PersonaStore's ID as the middle
component in its UID, which meant that the same IM address as added on two
different accounts using the same protocol would have the same UID,
undermining the concept of a UID as a globally unique identifier for a
Persona.

Closes: bgo#647121

Bug 647562 — Don't crash on duplicate group channels

Add download-page and bug-database entries to DOAP file.

Add a (long) description to the DOAP file.

Bug 645388 — Group channels are leaked

Post-release version bump.

Release version 0.5.0

Add NEWS entry for potential matches.

Add NEWS entry for the WebServiceDetails interface.

Add NEWS entry for LocalIdDetails interface

folks-inspect: Fix crashes when trying auto completion with parameters

Drop CCode since Vala uses null terminated arrays by default.

Closes: bgo#647298

Add test for setting an existing email an a Trf.Persona

Handle setting existing emails/phones in a Trf.Persona

linking: check if details contain im-addresses or web-service-addresses

It fixes a regression in add_persona_from_details introduced by this commit:

commit 4a8b46e6b7afd314807865586a60995dfe52896f
Author: Raul Gutierrez Segales <raul.gutierrez.segales@collabora.co.uk>
Date:   Fri Apr 8 16:03:11 2011 +0100

    Only add available properties when linking Personas

Bug: https://bugzilla.gnome.org/show_bug.cgi?id=647200

Revert "Temporarily disable lsw aggregation test. See bgo#647200"

This reverts commit bf218ed4ae92158e676c73ee15b774b41e0a8993.

phone-details: move a comment to make valadoc happy

tracker tests: fix Makefile.am

Fixed problem with saving results in get_all_potential_matches

PotentialMatch: make result_to_string a class method

String should be `very low` instead of `very unlikely`

Add test for get_{all}_potential_matches APIs

Add test to match via name similarity

Add test to match via phone numbers

Add test to avoid matching known e-mail addresses

Add test to match via e-mail addresses

Add test to match via IM Addresses

Add support to perform potential matches among Individuals

Add helper method to normalise and compare phone numbers

Add Folks.Utils to group helper methods

Temporarily disable lsw aggregation test. See bgo#647200

Bump libsocialweb version.

This version is required so we can rely upon correct D-Bus signaling from
libsocialweb.

Implement web-service-details for Trf.Personas

Add test for linking 2 Trf.Personas via local_ids

Extend IndividualAggregator to support linking via local_ids

Implement LocalIDDetails for Folks.Individual

[Tracker] Implement support for LocalIDDetails

Add LOCAL_IDS to the known defined keys for add_persona_from_details

Add LocalIdDetails interface to link Personas from Tracker

Remove a print statement that was used for debugging

List Folks.PersonaDetail in alphabetical order