*
* See {@link Folks.PersonaStore.can_add_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_add_personas
{
*
* See {@link Folks.PersonaStore.can_alias_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_alias_personas
{
*
* See {@link Folks.PersonaStore.can_group_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_group_personas
{
*
* See {@link Folks.PersonaStore.can_remove_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_remove_personas
{
*
* See {@link Folks.PersonaStore.is_prepared}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override bool is_prepared
{
* @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)
{
* @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)
{
*
* See {@link Folks.PersonaStore.can_add_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_add_personas
{
*
* See {@link Folks.PersonaStore.can_alias_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_alias_personas
{
*
* See {@link Folks.PersonaStore.can_group_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_group_personas
{
*
* See {@link Folks.PersonaStore.can_remove_personas}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override MaybeBool can_remove_personas
{
*
* See {@link Folks.PersonaStore.is_prepared}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public override bool is_prepared
{
/**
* Returns "service1:addr1,addr2;service2:addr3,.."
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static string serialize_web_services (HashMap<string,
LinkedHashSet<string>> ws_obj)
* 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)
/**
* Transform HashSet<string> to "id1,id2,.."
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static string serialize_local_ids (Gee.HashSet<string> local_ids)
{
/**
* Transform from id1,id2,.. to HashSet<string>
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static Gee.HashSet<string> unserialize_local_ids (string local_ids)
{
* @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)
{
# 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],
* - 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
{
/**
* 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)
/**
* Get all combinations between all {@link Individual}s.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public HashMap<Individual, HashMap<Individual, MatchResult>>
get_all_potential_matches
* 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
{
* 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; }
}
* @return `true` if all the components are the same, `false`
* otherwise.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public bool equal (StructuredName other)
{
* Definition of the available fields to be looked up with
* {@link PersonaStore.detail_key}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public enum Folks.PersonaDetail
{
*
* Should be kept in sync with {@link Folks.PersonaDetail}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
private static const string _PERSONA_DETAIL[] = {
"alias",
*
* @param detail the {@link PersonaDetail} to lookup
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static unowned string detail_key (Folks.PersonaDetail detail)
{
/**
* Normalise and compare two phone numbers.
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static bool numbers_equal (string number1, string number2)
{
* - +1-800-123-4567 --> 18001234567
* - +1-800-123-4567P123 --> 18001234567P123
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static string normalise_number (string number)
{
/**
* Returns the given number without it's extension (if any).
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
internal static string drop_extension (string number)
{
* This class provides functionality to explore a potential match between
* two individuals.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
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)
{
/**
* Keep in sync with Folks.MatchResult.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public static string result_to_string (MatchResult result)
{
* - 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 ()
{
/**
* Number of equal IM addresses between two individuals.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
public void _inspect_im_addresses ()
{
/**
* Inspect email addresses.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
private void _inspect_emails ()
{
* web service addresses exposed by an object implementing
* {@link PresenceDetails}.
*
- * @since UNRELEASED
+ * @since 0.5.0
*/
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