inspect: Update folks-inspect for the FieldDetails changes

Make the EDS backend's system address book the default writeable

Closes: bgo#648818 - Support the EDS backend being a primary

Trivial NEWS clean-up.

Remove FieldDetails (obsoleted by AbstractFieldDetails and implementors)

Support vCard-like parameters for URLs

Closes: bgo#655922 - Rebase UrlDetails.urls upon an
AbstractFieldDetails-derived class

Support vCard-like parameters for Roles

Closes: bug#655921 - Change RoleDetails.roles to support vCard-like arbitrary parameters

Support vCard-like parameters for web service addresses

Closes: bgo#653682 - Change WebServiceDetails.web_service_addresses to support
vCard-like arbitrary parameters

Rebase PhoneDetails.phone_numbers upon PhoneFieldDetails

Closes: bgo#655920 - Rebase PhoneDetails.phone_numbers upon an
AbstractFieldDetails-derived class

Allow for Individual replacement in the EDS add-persona test.

Rebase NoteDetails.notes upon NoteFieldDetails

Closes: bgo#655919 - Rebase NoteDetails.notes upon an
AbstractFieldDetails-derived class

Set the eds backend as the primary for the eds tests.

This fixes the eds/link-personas test.

Rebase EmailDetails.email_addresses upon EmailFieldDetails

Closes: bgo#655917 - Rebase EmailDetails.email_addresses upon an
AbstractFieldDetails-derived class

Run key-file tests later, since it's a low-priority backend.

Run Tracker tests last, since it's a low-priority backend.

They're also most likely to fail for reasons outside of our control.

Add utility function to compare MultiMaps of AbstractFieldDetails.

Clarify parameters for PostalAddressOwnerDetails.

Add basic equality testing for ImFieldDetails.

Helps: bug#653680 - Change ImDetails.im_addresses to support vCard-like
arbitrary parameters

Support vCard-like parameters for IM addresses

Helps: bug#653680 - Change ImDetails.im_addresses to support vCard-like
arbitrary parameters

Clean up the way the Tracker backend tracks IM addresses.

Helps: bug#653680 - Change ImDetails.im_addresses to support vCard-like
arbitrary parameters

Don't spill over 80 characters.

Support vCard-like parameters for addresses in PostalAddressDetails.

This also removes the older, less-functional, less-consistent
PostalAddress.types.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Add test for parameter equality in FieldDetails.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Add basic equality testing for FieldDetails.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Add parameters as an optional argument to the FieldDetails constructor.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Implement FieldDetails.equal()/hash() in terms of the default.

This allows explicit references to FieldDetails.equal()/hash() for
structures storing them (in case it changes from the
AbstractFieldDetails implementation in the future).

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Add equal() and hash() functions to AbstractFieldDetails.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Centralize parameters to AbstractFieldDetails.

This cuts some lines of code from the derived classes.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

Rebase FieldDetails upon an abstract and generic version of itself.

This should be useful for cases where the value has a very specific type
(eg, for PostalAddressDetails.postal_addresses). We'll create subclasses of
FieldDetails for those cases.

When we've created all the appropriate derived classes, we'll remove
FieldDetails entirely.

Helps: bgo#653679 - Change PostalAddressDetails.postal_addresses to
support vCard-like arbitrary parameters

core: Expand the documentation of EmailDetails.email_addresses

build: Add VAPI dependencies for eds backend

core: Fix a typo in NoteDetails documentation

Bug 653619 — Add company details

I dislike Tracker, ontologies, Sparql and drinking games.

Closes: bgo#653619

eds: Fix a minor type problem in the add-contacts-stress-test

build: Build eds backend by default

Signed-off-by: Raul Gutierrez Segales <rgs@collabora.co.uk>

e-d-s: fix link personas test

We've changed the way we set up the writeable store in
commit 5c062183b (bug #654907) and that broke this test.

Don't set a timeout for contacts adding stress test

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

Bug 655008 — Tidy up error handling in eds backend

Return more specific error codes from Edsf.PersonaStore methods where
possible, and in all cases make sure we've got a switch statement on the
incoming error code. Closes: bgo#655008

Clarify the documentation of PersonaStore.is_writeable

Closes: bgo#652657

Bug 649296 — Folks backend files shouldn't begin with "lib"

Rename the backend library files from “libfolks-backend-${BACKEND_NAME}.so”
to “${BACKEND_NAME}.so”.

Closes: bgo#649296

eds: Minor fixes to documentation comment syntax

e-d-s: add test for Gender property

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

e-d-s: Implement read/write support for gender property

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

Configure the writeable store by type_id and store id

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

Add rules for uploading generated docs to freedesktop.org

In the future, we should copy the remaining rules from telepathy-glib's setup,
which restrict doc uploads to releases (as well as simplifying other details of
releases).

Build eds docs along with others.

Fix syntax error in valadoc for Edsf.PersonaStore.remove_persona.

Fix syntax error in valadoc for Edsf.PersonaStore.prepare.

Fix link in Edsf.Persona docs to Folks.AvatarDetails.avatar.

Build libsocialweb docs along with others.

Fix link in Swf.Persona docs to Folks.AvatarDetails.avatar.

Fix link in Trf.Persona docs to Folks.AvatarDetails.avatar.

Centralize .PHONY doc targets.

Centralize definition of doc dirs to distclean.

Bump the required version of valadoc.

Actually check for the valadoc version when building docs.

Work around valadoc parsing bug with indented comments.

Give public access to properties for which there is write support

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

Make the Edsf.Persona class follow our coding style

Besides adhering to our coding style, this also
works around a bug in Vala that allows accessing

public string foo { get; set; }

through _foo.

Works around: https://bugzilla.gnome.org/show_bug.cgi?id=655741

core: Remove unused PotentialMatch.result_to_string() method

docs: Fix up lots of minor issues in the documentation comments

core: Make PotentialMatch.jaro_dist() private

inspect: Add a linking command

individual: Fix linking when personas are moved between individuals weirdly

It's possible (likely, even) for a set of personas to move between two
individuals during linking. Previously, bad things would happen to
persona.individual if the personas weren't correctly removed from the first
individual before being added to the second (e.g. if they were added to the
second individual before being removed from the first). This fixes that.

tests: Add a basic refcounting test for linked individuals

individual: Add more debug output to Individual

aggregator: Ensure we don't remove Personas we're adding

If a two Personas with the same UID are in the added and removed sets for a
single call to personas_changed_cb() in the individual aggregator, make sure
that we remove the old instance and replace it with the new instance, instead
of just removing both instances. This covers the case where the real instance
of a (Tpf.) Persona disappears and is immediately replaced by its cached
copy.

NOTE: This needs more testing.

Bug 652643 — Add PersonaStore cache

Use ObjectCache in Tpf.PersonaStore.

Closes: bgo#652643

Add a generic caching object to the core of folks

This adds the ObjectCache API.

Helps: bgo#652643

Unset the self-contact on Tpf.PersonaStore when resetting the store

Bug 650414 — Need better APIs to handle image data

Change AvatarDetails.avatar to have type LoadableIcon. By introducing
a libfolks-wide avatar cache, propagate this change to all the backends.

This breaks the API of AvatarDetails.

Closes: bgo#650414

Add missing copyright/license notices to tests.

Don't notify twice for EDS Persona nickname changes.

Closes: bgo#655019 - Don't notify twice for nickname changes

Return early when setting an Edsf.Persona attribute to its current value.

Helps: bgo#655019 - Don't notify twice for nickname changes

Allow Edsf.PersonaStore._set_*name() sname arg to be null.

Helps: bgo#655019 - Don't notify twice for nickname changes

Allow Edsf.PersonaStore._set_*avatar() avatar arg to be null.

Helps: bgo#655019 - Don't notify twice for nickname changes

Make Folks.Utils public and add Gee structure equality checking.

Helps: bgo#655019 - Don't notify twice for nickname changes

Update for 142f9b74: make Individual.calendar_event_id nullable

Un-break the EDS PersonaStore test for groups.

Make BirthdayDetails.calendar_event_id nullable

This includes expanding its documentation a little.

Fix visibility of TrfPersona.postal_addresses setter

Add a default implementation of TrfPersona.calendar_event_id

It was missing; it might as well return a sensible default value and not
allow setting of the value rather than doing nothing.

Fix visibility of TpfPersona.avatar and SwfPersona.avatar setters

Minor documentation fix for SwfPersona.avatar

Bug 650422 — Add API for easily checking whether details are writeable

Add Persona.writeable_properties, listing the properties of that Persona
for which updated values will be stored. It's intended that the property
value will be constant for a given Persona subclass, but this isn't
guaranteed; it's possible that Persona subclasses may vary the value of
writeable-properties at run time in future.

Closes: bgo#650422

Minor style change in presence-details.vala

Moved left brace of enum from end of line
to start of next line to match Folks style.

Bug 645549 — Add a way to get the individual from a persona

Add a Persona.individual property which is updated by
Individual._connect_to_persona() and ._disconnect_from_persona() as
appropriate, so should remain in lock-step with the Individual whose persona
set the Persona instance is currently in.

Closes: bgo#645549

Ensure that all modifications of Individual.personas happen in _set_personas()

This ensures that signals are handled consistently, and the overall internal
state of the Individual is kept consistent. This probably also fixes the
implementation of store_removed signal handling for Individuals, which looked
rather broken.

Fix the error domain of PersonaStore.remove_persona()

Bug 652425 — Failure codes for removing personas needed in PersonaStoreError

Add PersonaStoreError.PERMISSION_DENIED and PersonaStoreError.REMOVE_FAILED,
which will be useful for the e-d-s backend.

Closes: bgo#652425

Remove  AliasDetails support from Trf.Persona

The persona's alias was being stored as its nickname. Since we want to make
nicknames writeable (bgo#652048) we have to store the nickname there
instead. There's no ontology for storing aliases, so AliasDetails support
has to be dropped.

Closes: bgo#652048 — Make Individual.nickname writeable

Support nickname writability in the EDS backend.

Helps: bgo#652048 — Make Individual.nickname writeable

Allow NameDetails.nickname to be writeable

Helps: bgo#652048 — Make Individual.nickname writeable

Un-break parallel building the eds backend.

It would fail after a maintainer-clean or distclean with:

make[4]: *** No rule to make target `folks-eds.vapi', needed by `all-am'.
  Stop.
make[4]: *** Waiting for unfinished jobs....

This is because we were setting VALAFLAGS, which was overriding the
definition from configure.ac and generally causing havok.

Cut unreachable libsocialweb test code.

eds: Add support for contact groups/categories

eds: Mark read-only address books as non-addable-to and non-removable-from

eds: Fix persona store removal in the Backend

Embarrassing typo.

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”.