Add IndividualAggregator.link_personas() and .unlink_individual() API

These methods allow persistent linking and unlinking of Personas, compared to
the transient linking which editing Individual.personas provides. This allows
for an interface to preview the properties of a newly linked Individual
before committing the changes using IndividualAggregator.link_personas().

Implement the IMable interface on TpfPersona

Use it to expose the Persona's IM address. Do not allow setting the IM
address.

Take "im-addresses" as the parameter for a new Kf.Persona

This allows construction of new key file personas which contain multiple
IM addresses from different protocols.

Use autogenerated numeric IDs for key file groups

Let the IndividualAggregator designate one PersonaStore as its writeable store

Allow late linking of Individuals if Personas are added at runtime

If a Persona is added after the initial aggregation phase and it should be
linked to more than one existing Individual, the Individuals are now destroyed
and their Personas added to a new linked Individual containing the late
Persona.

This is necessary for supporting runtime linking and unlinking of Personas.

Specify a replacement Individual in Individual.removed()

This allows clients to better keep track of which Individuals have been
removed through the user linking them with other Individuals, and which have
been removed for more mundane reasons.

Warn if the MIME type of a potential backend couldn't be determined

This prevents backends silently not being loaded if shared-mime-info wasn't
installed. Closes: bgo#626108

Add @since lines to the documentation of some new methods

Add a display-name property to PersonaStore

This is equivalent to display-id for Persona.

Add the display-id property to Persona.

This is meant to be a human-readable, familiar identifier for presenting to the
user (when absolutely necessary).

Use the Persona's UID instead of the IID as the Individual's ID

Because the UID is globally unique, so this ensures that Individuals'
IDs are globally unique.

Allow specifying the key file to load via an environment variable

Add the key-file backend to the documentation build

This requires filtering out the BackendFactory Vala files, since they contain
global symbols (module_init(), module_finalize(), backend_factory) in both
backends, which conflict in the documentation.

Tidy up UIDs and IIDs in the backends

IIDs are now defined as unique within a backend, and formatted to make them
most useful for linking. UIDs are now defined as unique across all backends,
and formatted as Backend.name:PersonaStore.id:Persona ID.

Add linking support to the IndividualAggregator

Personas are linked together to form Individuals using a link map containing
mappings from UIDs and linkable properties to Individual instances. This
takes PersonaStore trust levels into account.

Add a key-file backend

This backend stores Personas in a key file which is completely under the
user's control, making it the only fully trusted Backend. Currently, it only
stores IM addresses, which can then be used as linkable properties by the
IndividualAggregator to link together Personas from multiple backends to
automagically produce Individuals.

Add PersonaStore trust levels

The Personas from each PersonaStore now have an assigned trust level (none,
partial or full) which indicates how much of their data can be used for
linking Personas together to form Individuals.

At the moment, the key-file backend is hard-coded as having the only fully
trusted PersonaStore.

Add IMable interface

Add concept of linkeable properties to Persona

Downgrade UID-as-alias warning to just a message

It's routinely triggered by the key-file backend, and doesn't need to
be a warning anyway.

Manually iterate through personas in remove_individual().

This lets us properly yield upon remove_persona().

Set the autoconf link to folks bugzilla.

Don't warn when adding an existing contact.

Closes bgo#625830

Post-release version bump and non-release indicator

Release version 0.1.12

Bump revision, in anticipation of release.

Version the installed backends using the LT current version number

This changes with every API/ABI change which is made to libfolks,
so it should ensure that only binary compatible modules are loaded
at runtime.

Handle connections which are ready as soon as they're connected

This fixes contacts from Facebook and MSN accounts sometimes not showing up
in the contact list. Closes: bgo#625815

Bump Vala version requirement.

We actually depended on this version de facto as soon as we added the debugging
clean-ups.

Add some more debug output to the Telepathy backend

Don't log errors in tp-lowlevel functions if they return a GError

Let the higher-level code decide whether a message or warning needs to
be logged to the terminal instead.

Use g_message() in tp-lowlevel rather than g_warning()

Any of the tp-glib calls we make could routinely fail, so to stop gdb
halting on every warning, change them to messages.

Change a message() to a debug()

Add debug flags support

Debug flags for libfolks, controlling which debug domains spew messages, can
be specified using the FOLKS_DEBUG environment variable, with a GLib-style
debug flags string.

The two initial debug domains are:
 * Core: everything in the folks directory
 * TelepathyBackend: everything in the backends/telepathy directory

Post-release version bump.

Update (a little late) the LT versioning fields for 0.1.11

Ensure all methods that should be async are, to get API breaking out of the way.

Always throw an error in async functions, to avoid breaking (C) API later.

Merge remote branch 'pwith/offline-fixes' into prep-0.1.11

Make remove_persona() and remove_individual() async

They could involve blocking operations, so should be async.

Reset the TpfPersonaStore state when going offline

Emit a signal to remove all the Personas, then reset the store's state
so that it can come online again later from a clean slate.

Don't hold a reference to the Account when iterating through an Account list

Don't emit "group invalidated" warnings when disconnecting

Don't initialise favourite contacts support if the Logger doesn't exist

Fix Presence.is_online()

Due to a signed/unsigned int problem, typecmp() was never returning
negative answers, so everyone was always online.

Split setup of the IndividualAggregator out into a .prepare() method

Split setup of Backends out into a Backend.prepare() method

Split setup of PersonaStores out into a PersonaStore.prepare() method

This allows the PersonaStore.personas_added and PersonaStore.personas_removed
signals to be connected to before the PersonaStore could first emit them,
removing a race condition.

Only connect to group-changed signals if the Persona implements Groups

Post-release version bump.

Cut unnecessary dbus-glib flags from the libfolks build process.

Explicitly build and link generated C code against telepathy-glib as necessary.

Explicitly link libfolks-telepathy against libfolks.

Explicitly build and link generated C code against GIO as necessary.

Merge remote branch 'pwith/refcount-on-remove'

Don't give libtp-lowlevel a version number, since it's purely internal.

Set the version info for the public libraries.

Add some basic info to the README.

Only unref a Persona if we actually held a reference to it in the first place

Since every Individual is notified of changes to the set of Personas in a
PersonaStore, many of the Personas it's passed won't belong to it. This
ensures that the Individual only unrefs Personas which belonged to it.

Make some Persona instances unowned

In trivial cases where we're iterating through a list of owned Personas, there
is no need to ref/unref for each iteration. This makes debugging refcount
issues a lot easier.

Fix our category in the Gnome git system (take the default).

Add general project and maintainer information.

Bump the version for the next release properly, with a new micro number.

Merge remote branch 'pwith/build-cleanup'

Performed quite a modifications to this branch, as it wasn't rebased on top of
the latest build changes (which also made "make distclean" work for the first
time).

Conflicts:
backends/telepathy/Makefile.am
configure.ac

Bump the configure-time glib requirement (which was implicitly required by our Vala flags).

Merge remote branch 'pwith/gi-bindings-rebase4'

Tidy up dependencies in the Telepathy backend

Remove unnecessary dependencies from folks-telepathy.deps

Remove redundant suffix substitutions in the Telepathy Makefile

Rename VALASOURCES variables in Telepathy backend

They shouldn't be in upper case, as they could conflict with variables
used by future versions of automake.

Rearrange the libfolks Makefile

Commonly-changed variables are now nearer the top. libfolks_la_VALASOURCES
has been renamed to folks_valasources so that it doesn't conflict with any
future automake rules of the same name. Various small formatting changes have
been made too.

Remove redundant suffix substitutions in the libfolks Makefile

Remove telepathy-vala dependencies from libfolks

Tidy up the valac flags for libfolks

Remove unnecessary dependencies from folks.deps

They're not exposed in the public API, so there's no need to list
them as dependencies.

Silence the documentation build

Consolidate the tp-vala valaflags into configure.ac

Rather than calling pkg-config from various Makefiles to find out the
same information.

Add git.mk for automatic .gitignore generation

git.mk is copied from pango/git.mk, which is the canonical place to
look for updates to it. It hasn't been modified.

Add generated files to MAINTAINERCLEANFILES

Don't install or EXTRA_DIST the package documentation

It's unnecessary, and automake knows to distribute the files already.

Fix ChangeLog cleaning

It should be removed optionally during distclean, and forcibly during
maintainerclean.

Remove unused gtk-doc lines from build system

We use valadoc instead.

Remove unused scrollkeeper lines from Makefile

Remove some unused lines from the configure summary

Remove some barely-used silent build machinery from the Makefiles

Fix MIME type memory leak in BackendStore

Don't leak TpfPersona references for each Individual

Due to bgo#624249, GLib.List.remove() leaks an item reference, so we need to
manually unreference each persona we remove from the personas list in
Individual.

Break a refcycle between TpfPersonaStore and TpfPersona

This is achieved by making the pointer that each TpfPersona holds to their
relevant TpfPersonaStore a weak pointer, rather than a referenced pointer.

Allow backends to be completely unloaded

This means that if the IndividualAggregator is finalized, all the resources
used by the backends which were loaded are freed. This allows multiple
IndividualAggregator instances to be used sequentially, and also ensures that
all Persona instances get destroyed.

Explicitly require Vala.

Bump nano version after release.

Distribute the tp-lowlevel metadata file to fix distcheck.

Specify tp-lowlevel.h being in the srcdir, to work around a vala-gen-introspect bug.

Specify the vala source files being in the srcdir, to work around a valac bug.

Work around bgo #624278 for distcheck

Include the backends/telepathy/*.vala files when making a relese.

Include the folks/*.vala files when making a relese.

Ensure we don't unref every TpAccount

AccountManager.get_valid_accounts() only transfers the container, and
Vala ignores this unless you assign it to a variable with an unowned
item type.

Remove extraneous array length parameter

change_favourites_by_request_handles no longer needs an explicit array
length parameter, due to changes in Connection.request_handles.