Release version 0.5.0FOLKS_0_5_0

12 files changed, 41 insertions, 41 deletions

diff --git a/backends/libsocialweb/lib/swf-persona-store.vala b/backends/libsocialweb/lib/swf-persona-store.vala
index f5f73c7c..0effd7a1 100644
--- a/backends/libsocialweb/lib/swf-persona-store.vala
+++ b/backends/libsocialweb/lib/swf-persona-store.vala
@@ -50,7 +50,7 @@ public class Swf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_add_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_add_personas
     {
@@ -62,7 +62,7 @@ public class Swf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_alias_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_alias_personas
     {
@@ -74,7 +74,7 @@ public class Swf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_group_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_group_personas
     {
@@ -86,7 +86,7 @@ public class Swf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_remove_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_remove_personas
     {
@@ -98,7 +98,7 @@ public class Swf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.is_prepared}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override bool is_prepared
     {
diff --git a/backends/libsocialweb/lib/swf-persona.vala b/backends/libsocialweb/lib/swf-persona.vala
index 270f0976..e3dc611b 100644
--- a/backends/libsocialweb/lib/swf-persona.vala
+++ b/backends/libsocialweb/lib/swf-persona.vala
@@ -126,7 +126,7 @@ public class Swf.Persona : Folks.Persona,
    * @param lsw_id the lsw id
    * @return the Facebook JID or null if it is not a Facebook contact
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   internal static string? _build_facebook_jid (string store_id, string lsw_id)
     {
@@ -147,7 +147,7 @@ public class Swf.Persona : Folks.Persona,
    * @param lsw_id the lsw id
    * @return a valid IID
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   internal static string _build_iid (string store_id, string lsw_id)
     {
diff --git a/backends/tracker/lib/trf-persona-store.vala b/backends/tracker/lib/trf-persona-store.vala
index c5d395ed..404f2074 100644
--- a/backends/tracker/lib/trf-persona-store.vala
+++ b/backends/tracker/lib/trf-persona-store.vala
@@ -296,7 +296,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_add_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_add_personas
     {
@@ -308,7 +308,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_alias_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_alias_personas
     {
@@ -320,7 +320,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_group_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_group_personas
     {
@@ -332,7 +332,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.can_remove_personas}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override MaybeBool can_remove_personas
     {
@@ -344,7 +344,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    *
    * See {@link Folks.PersonaStore.is_prepared}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public override bool is_prepared
     {
@@ -721,7 +721,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
  /**
    * Returns "service1:addr1,addr2;service2:addr3,.."
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
    public static string serialize_web_services (HashMap<string,
       LinkedHashSet<string>> ws_obj)
@@ -758,7 +758,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
    * Transforms "service1:addr1,addr2;service2:addr3,.." to
    *   --->  HashMap<string, LinkedHashSet<string>>
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static HashMap<string, LinkedHashSet<string>> unserialize_web_services
       (string ws_addrs)
@@ -788,7 +788,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
  /**
    * Transform HashSet<string> to "id1,id2,.."
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public  static string serialize_local_ids (Gee.HashSet<string> local_ids)
     {
@@ -809,7 +809,7 @@ public class Trf.PersonaStore : Folks.PersonaStore
   /**
    * Transform from id1,id2,.. to HashSet<string>
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static Gee.HashSet<string> unserialize_local_ids (string local_ids)
     {
diff --git a/backends/tracker/lib/trf-persona.vala b/backends/tracker/lib/trf-persona.vala
index 1101b0cd..93cd4402 100644
--- a/backends/tracker/lib/trf-persona.vala
+++ b/backends/tracker/lib/trf-persona.vala
@@ -350,7 +350,7 @@ public class Trf.Persona : Folks.Persona,
    * @param tracker_id the tracker id belonging to nco:PersonContact
    * @return a valid IID
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   internal static string build_iid (string store_id, string tracker_id)
     {
diff --git a/configure.ac b/configure.ac
index 7068893c..d780fd06 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_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], [22])
+m4_define([folks_lt_current], [23])
 m4_define([folks_lt_revision], [0])
-m4_define([folks_lt_age], [0])
+m4_define([folks_lt_age], [1])
 
 # Display the nano_version only if it's not '0'
 m4_define([folks_base_version],
diff --git a/folks/individual-aggregator.vala b/folks/individual-aggregator.vala
index 75ad1b1f..ce60273c 100644
--- a/folks/individual-aggregator.vala
+++ b/folks/individual-aggregator.vala
@@ -88,7 +88,7 @@ public class Folks.IndividualAggregator : Object
    * - the GConf key set in _FOLKS_CONFIG_KEY (system set store)
    * - going with the `key-file` store as the fall-back option
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public PersonaStore primary_store
     {
@@ -228,7 +228,7 @@ public class Folks.IndividualAggregator : Object
   /**
    * Get all matches for a given {@link Individual}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public HashMap<Individual, MatchResult> get_potential_matches
       (Individual matchee, MatchResult min_threshold = MatchResult.VERY_HIGH)
@@ -255,7 +255,7 @@ public class Folks.IndividualAggregator : Object
   /**
    * Get all combinations between all {@link Individual}s.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public HashMap<Individual, HashMap<Individual, MatchResult>>
       get_all_potential_matches
diff --git a/folks/local-id-details.vala b/folks/local-id-details.vala
index c6ba84ea..b09d0851 100644
--- a/folks/local-id-details.vala
+++ b/folks/local-id-details.vala
@@ -26,7 +26,7 @@ using GLib;
  * to {@link Persona}s from backends with write support so
  * that they can be linked.
  *
- * @since UNRELEASED
+ * @since 0.5.0
  */
 public interface Folks.LocalIdDetails : Object
 {
@@ -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.0
    */
   public abstract HashSet<string> local_ids { get; set; }
 }
diff --git a/folks/name-details.vala b/folks/name-details.vala
index d06011b0..ed808cca 100644
--- a/folks/name-details.vala
+++ b/folks/name-details.vala
@@ -170,7 +170,7 @@ public class Folks.StructuredName : Object
    * @return `true` if all the components are the same, `false`
    * otherwise.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public bool equal (StructuredName other)
     {
diff --git a/folks/persona-store.vala b/folks/persona-store.vala
index 56522f5f..f01bc5ec 100644
--- a/folks/persona-store.vala
+++ b/folks/persona-store.vala
@@ -104,7 +104,7 @@ public errordomain Folks.PersonaStoreError
  * Definition of the available fields to be looked up with
  * {@link PersonaStore.detail_key}.
  *
- * @since UNRELEASED
+ * @since 0.5.0
  */
 public enum Folks.PersonaDetail
 {
@@ -148,7 +148,7 @@ public abstract class Folks.PersonaStore : Object
    *
    * Should be kept in sync with {@link Folks.PersonaDetail}.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   private static const string _PERSONA_DETAIL[] = {
     "alias",
@@ -175,7 +175,7 @@ public abstract class Folks.PersonaStore : Object
    *
    * @param detail the {@link PersonaDetail} to lookup
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static unowned string detail_key (Folks.PersonaDetail detail)
     {
diff --git a/folks/phone-details.vala b/folks/phone-details.vala
index 6226b7ab..fb824b2e 100644
--- a/folks/phone-details.vala
+++ b/folks/phone-details.vala
@@ -46,7 +46,7 @@ public interface Folks.PhoneDetails : Object
 
   /**
    * Normalise and compare two phone numbers.
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static bool numbers_equal (string number1, string number2)
     {
@@ -79,7 +79,7 @@ public interface Folks.PhoneDetails : Object
    *  - +1-800-123-4567 --> 18001234567
    *  - +1-800-123-4567P123 --> 18001234567P123
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static string normalise_number (string number)
     {
@@ -131,7 +131,7 @@ public interface Folks.PhoneDetails : Object
   /**
    * Returns the given number without it's extension (if any).
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   internal static string drop_extension (string number)
     {
diff --git a/folks/potential-match.vala b/folks/potential-match.vala
index f761394f..9f074b71 100644
--- a/folks/potential-match.vala
+++ b/folks/potential-match.vala
@@ -39,7 +39,7 @@ public enum Folks.MatchResult
  * This class provides functionality to explore a potential match between
  * two individuals.
  *
- * @since UNRELEASED
+ * @since 0.5.0
  */
 public class Folks.PotentialMatch : Object
 {
@@ -65,7 +65,7 @@ public class Folks.PotentialMatch : Object
   /**
    * Whether two individuals are likely to be the same person.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public MatchResult potential_match (Individual a, Individual b)
     {
@@ -126,7 +126,7 @@ public class Folks.PotentialMatch : Object
   /**
    * Keep in sync with Folks.MatchResult.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public static string result_to_string (MatchResult result)
     {
@@ -156,7 +156,7 @@ public class Folks.PotentialMatch : Object
    * - taking in account family, given, prefix, suffix and additional names
    *   we give some points for each non-empty match
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   private void _name_similarity ()
     {
@@ -213,7 +213,7 @@ public class Folks.PotentialMatch : Object
   /**
    * Number of equal IM addresses between two individuals.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   public void _inspect_im_addresses ()
     {
@@ -242,7 +242,7 @@ public class Folks.PotentialMatch : Object
   /**
    * Inspect email addresses.
    *
-   * @since UNRELEASED
+   * @since 0.5.0
    */
   private void _inspect_emails ()
     {
diff --git a/folks/web-service-details.vala b/folks/web-service-details.vala
index 3afe19fe..7b470909 100644
--- a/folks/web-service-details.vala
+++ b/folks/web-service-details.vala
@@ -24,7 +24,7 @@ using Gee;
  * web service addresses exposed by an object implementing
  * {@link PresenceDetails}.
  *
- * @since UNRELEASED
+ * @since 0.5.0
  */
 public interface Folks.WebServiceDetails : Object
 {
@@ -39,7 +39,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.0
    */
   public abstract Gee.HashMap<string, LinkedHashSet<string>>
       web_service_addresses