Fix the configure output for docs.

Based upon a couple issues raised in bgo#653325

Bug 652660 — Make Individual.id more stable and well-defined

Don't make the folks-telepathy docs depend directly upon dbus-glib.

Closes: bgo#629716 - Migrate Folks to GDBus

Don't make the Libsocialweb backend depend directly upon dbus-glib.

Helps: bgo#629716 - Migrate Folks to GDBus

Don't make the Telepathy tests depend directly upon dbus-glib.

Helps: bgo#629716 - Migrate Folks to GDBus

Handle both the dbus-glib and GDBus missing logger errors.

Helps: bgo#629716 - Migrate Folks to GDBus

Update Tp test backend suppression to match GDBus behavior.

Helps: bgo#629716 - Migrate Folks to GDBus

Cut unnecessary log message suppressions in the Aggregation test.

Helps: bgo#629716 - Migrate Folks to GDBus

Properly disconnect the logger::invalidated handler.

Helps: bgo#629716 - Migrate Folks to GDBus

Port Tpf.Logger to GDBus.

Helps: bgo#629716 - Migrate Folks to GDBus

Factor out Tpf.Logger.prepare() from its constructor.

Helps: bgo#629716 - Migrate Folks to GDBus

Use the GLib definition of Error instead of DBus.Error.

Helps: bgo#629716 - Migrate Folks to GDBus

Use the GLib definition for Object.

Helps: bgo#629716 - Migrate Folks to GDBus

Use the GLib definition for ObjectPath.

Helps: bgo#629716 - Migrate Folks to GDBus

Don't build dbus-glib into Telepathy backend.

Helps: bgo#629716 - Migrate Folks to GDBus

Bug 652472 — Handle failure in getting the logger service better

If we fail to get the logger from the bus, get_object() may return NULL. If
we check for this, we don't then try and connect a signal to a NULL object
instance and emit criticals.

Closes: bgo#652472

Fix the link within the PresenceDetails.presence_status docs

Bug 648071 — Add support for presence status from Telepathy

Add a presence_status property to PresenceDetails to expose the detailed
presence status string that Telepathy exposes.

Closes: bgo#648071

Don't crash if a provided TpContact ID is NULL.

Don't add null Personas in personas-changed signal arguments.

Note closing of bgo#652434 — Add ability to run any tests through gdb

Closes: bgo#652434

Add ability to run any of our tests through gdb

Run a test through gdb with:

    make -C tests/<dir> <test name>.gdb

Cut redundant EXTRA_DIST entry.

More-cleanly define gir and vapi files.

Add Make rule for generating tracker-test.vapi.

After a maintainer-clean, Make doesn't know how to generate this file otherwise.

Dist but don't include the tracker-test vapi files.

Bug 652463 — Tidy up CLEANFILES

Tidy up pkg-config and configure-generated files in CLEANFILES and
DISTCLEANFILES.

Closes: bgo#652463

Bug 646244 — Incomplete logic to handle attribute updates in Folks.Individual

Tidy up some of the update methods in Folks.Individual to handle null values
a little better.

Closes: bgo#646244

Don't delete tp-test-contactlist.deps when maintainer-cleaning.

This fixes a bug introduced by b983fee7

Handle ownership of TpContact.connection automatically.

It recently changed in telepathy-glib and/or Vala 0.14.x finally detected that
the TpContact.connection property returns an owned TpConnection (making our use
of "unowned Connection connection = contact.connection" invalid).

Dist the tp-test-contactlist.deps file

It was missing from tarballs, which causes folks to fail to build
in some circumstances.

Move tracker's test image to a common location

Moving this to tests/data so it can be shared by other
backends.

Play nicely with new API in Vala 0.14

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

libsocialweb: Swf.Persona stores SocialWebClient.Contact

Closes: bgo#649925 - expose SocialWebClient.Contact in Swf.Persona

Post-release bump.

Release version 0.5.2.

Note fix for bgo#650268 build failure in NEWS.

Fix location of NEWS entry for bgo#650067 fix.

Define the proper autoconf constant when enabling the libsocialweb backend.

Don't re-build the vapi files unless we've been configured with Vala.

Don't require [lib]valadoc to build docs.

Only check for libsocialweb Vala deps if Vala is enabled.

Check for folks-telepathy.h in the proper dir when building docs.

[tracker] Deal with null Avatars being set on a Trf.Persona

Fixes: bgo#650067 - Tracker backend warns when setting a NULL
avatar (ie, unsetting the avatar)

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