Release Folks 0.5.1.

20 files changed, 49 insertions, 49 deletions

diff --git a/backends/tracker/lib/trf-persona-store.vala b/backends/tracker/lib/trf-persona-store.vala
index 8a806d4..775c272 100644
--- a/backends/tracker/lib/trf-persona-store.vala
+++ b/backends/tracker/lib/trf-persona-store.vala
@@ -714,7 +714,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
  /**
    * Returns "service1:addr1,addr2;service2:addr3,.."
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static string serialize_web_services (
       MultiMap<string, string> ws_obj)
@@ -751,7 +751,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    * Transforms "service1:addr1,addr2;service2:addr3,.." to
    *   --->  HashMultiMap<string, string>
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static MultiMap<string, string> unserialize_web_services
       (string ws_addrs)
@@ -777,7 +777,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
  /**
    * Transform HashSet<string> to "id1,id2,.."
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static string serialize_local_ids (Set<string> local_ids)
     {
@@ -798,7 +798,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
   /**
    * Transform from id1,id2,.. to HashSet<string>
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static Set<string> unserialize_local_ids (string local_ids)
     {
diff --git a/configure.ac b/configure.ac
index 55b9aa7..eb662fd 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,19 +1,19 @@
 # If not 1, append datestamp to the version number
-m4_define([folks_released], [0])
+m4_define([folks_released], [1])
 
 m4_define([folks_major_version], [0])
 m4_define([folks_minor_version], [5])
-m4_define([folks_micro_version], [0])
-m4_define([folks_nano_version], [1])
+m4_define([folks_micro_version], [1])
+m4_define([folks_nano_version], [0])
 
 # If library source has changed since last release, increment revision
 # If interfaces have been added, removed or changed since last release,
 #  increment current and set revision to 0
 # If interfaces have been added since last release, increment age
 # If interfaces have been removed since last release, set age to 0
-m4_define([folks_lt_current], [23])
+m4_define([folks_lt_current], [24])
 m4_define([folks_lt_revision], [0])
-m4_define([folks_lt_age], [1])
+m4_define([folks_lt_age], [0])
 
 # Display the nano_version only if it's not '0'
 m4_define([folks_base_version],
diff --git a/folks/backend-store.vala b/folks/backend-store.vala
index d8c21d8..a594cc5 100644
--- a/folks/backend-store.vala
+++ b/folks/backend-store.vala
@@ -88,7 +88,7 @@ public class Folks.BackendStore : Object {
    *
    * The backends in this list have been prepared and are ready to use.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Map<string, Backend> enabled_backends
     {
diff --git a/folks/backend.vala b/folks/backend.vala
index ace439c..db8d222 100644
--- a/folks/backend.vala
+++ b/folks/backend.vala
@@ -61,7 +61,7 @@ public abstract class Folks.Backend : Object
    * A backend may expose {@link Persona}s from multiple servers or accounts
    * (for example), so may have a {@link PersonaStore} for each.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Map<string, PersonaStore> persona_stores { get; }
 
diff --git a/folks/debug.vala b/folks/debug.vala
index 49ff79d..51f119d 100644
--- a/folks/debug.vala
+++ b/folks/debug.vala
@@ -37,7 +37,7 @@ private extern void g_log (string? log_domain,
  * allows debug domains to be outputted according to whether they've been
  * enabled by being passed to {@link Debug.dup}.
  *
- * @since UNRELEASED
+ * @since 0.5.1
  */
 public class Folks.Debug : Object
 {
@@ -65,7 +65,7 @@ public class Folks.Debug : Object
    *
    * This property is thread-safe.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public bool colour_enabled
     {
@@ -93,7 +93,7 @@ public class Folks.Debug : Object
    * debug domains; filtering of debug output as a whole is done after filtering
    * by enabled domains.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public bool debug_output_enabled
     {
@@ -123,7 +123,7 @@ public class Folks.Debug : Object
    * Client processes should emit this signal by calling
    * {@link Debug.emit_print_status}.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public signal void print_status ();
 
@@ -134,7 +134,7 @@ public class Folks.Debug : Object
    * This could be used in conjunction with a log handler to redirect the
    * status information to a debug window or log file, for example.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public const string STATUS_LOG_DOMAIN = "folks-status";
 
@@ -189,7 +189,7 @@ public class Folks.Debug : Object
    * This function is thread-safe.
    *
    * @return  Singleton {@link Debug} instance
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static Debug dup ()
     {
@@ -219,7 +219,7 @@ public class Folks.Debug : Object
    * @param colour_enabled Whether debug output should be coloured using
    * terminal escape sequences
    * @return Singleton {@link Debug} instance
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static Debug dup_with_flags (string? debug_flags,
       bool colour_enabled)
@@ -275,7 +275,7 @@ public class Folks.Debug : Object
    * status to standard output, obeying the options set on this
    * {@link Debug} instance for colouring and other formatting.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public void emit_print_status ()
     {
@@ -289,7 +289,7 @@ public class Folks.Debug : Object
    *
    * This is intended to be used by backend libraries only.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public void indent ()
     {
@@ -304,7 +304,7 @@ public class Folks.Debug : Object
    *
    * This is intended to be used by backend libraries only.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public void unindent ()
     {
@@ -322,7 +322,7 @@ public class Folks.Debug : Object
    * @param level A set of log level flags for the message
    * @param format A printf-style format string for the heading
    * @param ... Arguments for the format string
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   [PrintfFormat ()]
   public void print_line (string domain,
@@ -346,7 +346,7 @@ public class Folks.Debug : Object
    * @param level A set of log level flags for the message
    * @param format A printf-style format string for the heading
    * @param ... Arguments for the format string
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   [PrintfFormat ()]
   public void print_heading (string domain,
@@ -415,7 +415,7 @@ public class Folks.Debug : Object
    * @param domain The debug domain name
    * @param level A set of log level flags for the message
    * @param ... Alternating keys and values, terminated with null
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public void print_key_value_pairs (string domain,
       LogLevelFlags level,
diff --git a/folks/email-details.vala b/folks/email-details.vala
index e160a63..4838bed 100644
--- a/folks/email-details.vala
+++ b/folks/email-details.vala
@@ -32,7 +32,7 @@ public interface Folks.EmailDetails : Object
   /**
    * The email addresses of the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<FieldDetails> email_addresses { get; set; }
 }
diff --git a/folks/field-details.vala b/folks/field-details.vala
index daa670e..b5643c0 100644
--- a/folks/field-details.vala
+++ b/folks/field-details.vala
@@ -52,7 +52,7 @@ public class Folks.FieldDetails : Object
    * {@link Folks.FieldDetails.value}. The keys are the names of the
    * parameters, while the values are a list of strings.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public MultiMap<string, string> parameters { get; set; }
 
@@ -77,7 +77,7 @@ public class Folks.FieldDetails : Object
    * @return a collection of values for `parameter_name` or `null` (i.e. no
    * collection) if there are no such parameters.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Collection<string>? get_parameter_values (string parameter_name)
     {
@@ -129,7 +129,7 @@ public class Folks.FieldDetails : Object
    *
    * @param additional the parameters to add
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public void extend_parameters (MultiMap<string, string> additional)
     {
diff --git a/folks/group-details.vala b/folks/group-details.vala
index 7fc167c..2755a3b 100644
--- a/folks/group-details.vala
+++ b/folks/group-details.vala
@@ -119,7 +119,7 @@ public interface Folks.GroupDetails : Object
    * Freeform group IDs are mapped to a boolean which is `true` if the
    * contact is a member of the group, and `false` otherwise.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<string> groups { get; set; }
 
diff --git a/folks/im-details.vala b/folks/im-details.vala
index 9a24c7a..9435234 100644
--- a/folks/im-details.vala
+++ b/folks/im-details.vala
@@ -51,7 +51,7 @@ public interface Folks.ImDetails : Object
    * All the IM addresses must be normalised using
    * {@link ImDetails.normalise_im_address} before being added to this property.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract MultiMap<string, string> im_addresses
     {
diff --git a/folks/individual-aggregator.vala b/folks/individual-aggregator.vala
index ddaf293..0e8ec1e 100644
--- a/folks/individual-aggregator.vala
+++ b/folks/individual-aggregator.vala
@@ -109,7 +109,7 @@ public class Folks.IndividualAggregator : Object
    * {@link IndividualAggregator.add_persona_from_details} and
    * {@link IndividualAggregator.remove_individual}, respectively.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Map<string, Individual> individuals
     {
@@ -145,7 +145,7 @@ public class Folks.IndividualAggregator : Object
    * @param actor the {@link Persona} who made the change, if known
    * @param reason the reason for the change
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public signal void individuals_changed (Set<Individual> added,
       Set<Individual> removed,
@@ -335,7 +335,7 @@ public class Folks.IndividualAggregator : Object
   /**
    * Get all matches for a given {@link Individual}.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Map<Individual, MatchResult> get_potential_matches
       (Individual matchee, MatchResult min_threshold = MatchResult.VERY_HIGH)
@@ -362,7 +362,7 @@ public class Folks.IndividualAggregator : Object
   /**
    * Get all combinations between all {@link Individual}s.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Map<Individual, Map<Individual, MatchResult>>
       get_all_potential_matches
@@ -1074,7 +1074,7 @@ public class Folks.IndividualAggregator : Object
    * {@link Individual.removed}.
    *
    * @param personas the {@link Persona}s to be linked
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public async void link_personas (Set<Persona> personas)
       throws IndividualAggregatorError
diff --git a/folks/individual.vala b/folks/individual.vala
index 98c90e4..f71c3dc 100644
--- a/folks/individual.vala
+++ b/folks/individual.vala
@@ -453,7 +453,7 @@ public class Folks.Individual : Object,
    * {@link IndividualAggregator.unlink_individual}, which will ensure the link
    * changes are written to the appropriate backend.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Set<Persona> personas
     {
@@ -469,7 +469,7 @@ public class Folks.Individual : Object,
    * @param added a set of {@link Persona}s which have been added
    * @param removed a set of {@link Persona}s which have been removed
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public signal void personas_changed (Set<Persona> added,
       Set<Persona> removed);
@@ -605,7 +605,7 @@ public class Folks.Individual : Object,
    * {@link Individual} with, or `null`
    * @return a new Individual
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public Individual (Set<Persona>? personas)
     {
diff --git a/folks/local-id-details.vala b/folks/local-id-details.vala
index 9de6b07..93fd080 100644
--- a/folks/local-id-details.vala
+++ b/folks/local-id-details.vala
@@ -34,7 +34,7 @@ public interface Folks.LocalIdDetails : Object
    * The IDs corresponding to contacts in a
    * backend that we fully trust.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<string> local_ids { get; set; }
 }
diff --git a/folks/note-details.vala b/folks/note-details.vala
index 3e194eb..59abdb5 100644
--- a/folks/note-details.vala
+++ b/folks/note-details.vala
@@ -86,7 +86,7 @@ public interface Folks.NoteDetails : Object
   /**
    * The notes about the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<Note> notes { get; set; }
 }
diff --git a/folks/persona-store.vala b/folks/persona-store.vala
index e2f439f..f65f9f3 100644
--- a/folks/persona-store.vala
+++ b/folks/persona-store.vala
@@ -196,7 +196,7 @@ public abstract class Folks.PersonaStore : Object
    * @param actor the {@link Persona} who made the change, if known
    * @param reason the reason for the change
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public signal void personas_changed (Set<Persona> added,
       Set<Persona> removed,
@@ -284,7 +284,7 @@ public abstract class Folks.PersonaStore : Object
   /**
    * The {@link Persona}s exposed by this PersonaStore.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Map<string, Persona> personas { get; }
 
diff --git a/folks/phone-details.vala b/folks/phone-details.vala
index 449d0be..0aa3fd1 100644
--- a/folks/phone-details.vala
+++ b/folks/phone-details.vala
@@ -41,7 +41,7 @@ public interface Folks.PhoneDetails : Object
    *
    * A list of phone numbers associated to the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<FieldDetails> phone_numbers { get; set; }
 
diff --git a/folks/postal-address-details.vala b/folks/postal-address-details.vala
index 7c85e8f..7b30213 100644
--- a/folks/postal-address-details.vala
+++ b/folks/postal-address-details.vala
@@ -174,7 +174,7 @@ public class Folks.PostalAddress : Object
    * @param region the region (state or province) name
    * @param postal_code the postal code
    * @param address_format the address format
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public PostalAddress (string? po_box, string? extension, string? street,
       string? locality, string? region, string? postal_code, string? country,
@@ -241,7 +241,7 @@ public interface Folks.PostalAddressDetails : Object
    *
    * A list of postal addresses associated to the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<PostalAddress> postal_addresses { get; set; }
 }
diff --git a/folks/potential-match.vala b/folks/potential-match.vala
index 86a7cbd..daeb656 100644
--- a/folks/potential-match.vala
+++ b/folks/potential-match.vala
@@ -52,7 +52,7 @@ public class Folks.PotentialMatch : Object
    * A set of e-mail addresses known to be aliases of each other, such as
    * various forms of administrator address.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public static Set<string> known_email_aliases = null;
 
diff --git a/folks/role-details.vala b/folks/role-details.vala
index c039fc0..bc08d16 100644
--- a/folks/role-details.vala
+++ b/folks/role-details.vala
@@ -117,7 +117,7 @@ public interface Folks.RoleDetails : Object
   /**
    * The roles of the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<Role> roles { get; set; }
 }
diff --git a/folks/url-details.vala b/folks/url-details.vala
index e8b47ed..fa5c1ed 100644
--- a/folks/url-details.vala
+++ b/folks/url-details.vala
@@ -34,7 +34,7 @@ public interface Folks.UrlDetails : Object
    *
    * A list or websites associated to the contact.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Set<FieldDetails> urls { get; set; }
 }
diff --git a/folks/web-service-details.vala b/folks/web-service-details.vala
index 8770f76..7e848a0 100644
--- a/folks/web-service-details.vala
+++ b/folks/web-service-details.vala
@@ -37,7 +37,7 @@ public interface Folks.WebServiceDetails : Object
    * Web service addresses are guaranteed to be unique per web service, but
    * not necessarily unique amongst all web services.
    *
-   * @since UNRELEASED
+   * @since 0.5.1
    */
   public abstract Gee.MultiMap<string, string> web_service_addresses
     {