inspect: Don't print details of unprepared persona stores

We're not supposed to, and they're not very useful anyway. Instead, we now
print a message saying that the persona store is not prepared.

eds: Fix linker warnings for the e-d-s backend tests

eds: Fix a variable's visibility in the e-d-s Backend

This also takes the opportunity to s/addressbook/address book/ an environment
variable, since the official GNOME terminology is “address book” rather than
“addressbook”.

eds: Tidy up the e-d-s Backend.unprepare() method

This makes sure we disconnect from all the right signals, and abstracts
adding and removing address books out into a single pair of methods.

Update NEWS for bgo#654509.

Bump required version of Vala (needed for EDS).

Closes: bgo#654509 - Folks master not building

Set the backend name for the EDS backend.

Tidy up EDS CLEANFILES.

Re-locate the EDS headers.

This is related to bgo#649790 - Vala uses the wrong includes

eds: Add source list change notification to the eds backend

This means that Edsf.PersonaStores can come and go at run time.

This also adds a little bit of debug output to the eds Backend.

eds: Ensure that errors are thrown by Edsf.PersonaStore.prepare() properly

Add an EDS backend

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

Fix the valadoc string for FieldDetails.value.

Bug 653746 — mismatch between hash and equals in Note

Ensure that Note instances compare equal iff their UIDs are equal (as well as
iff their contents are equal).

Closes: bgo#653746

Re-add a dependency on dbus-glib for the Telepathy test library

Files in tests/lib/telepathy/contactlist/ still use dbus-glib, and have to
because they're also using telepathy-glib.

Fix a typo in the IndividualAggregator.individuals_changed docs.

Make valadoc a hard dependency when using --enable-docs

Closes: bgo#653325 — Build system does not complain if trying to build docs
without vala-doc installed

Bug 652449 — Folks.Individual's property getters should be read only

Make the getters of container types in Folks.Individual return read-only
views of the containers.

Closes: bgo#652449

Cut meaningless 'Tests' output from configure.

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