NEWS

   1 Overview of changes from libfolks 0.8.0 to libfolks 0.9.0
   2 =========================================================
   3
   4 Dependencies:
   5 • libgee ≥ 0.8.3
   6
   7 Major changes:
   8 • Added an ofono backend
   9 • Ported to libgee 0.8.x
  10
  11 Bugs fixed:
  12 • Bug 682941 — API to configure input of aggregation
  13 • Bug 685084 — Add a folks backend for ofono phonebook
  14 • Bug 686056 — Add api to create and remove address books
  15 • Bug 685250 — make <test>.gdb deadlocks
  16 • Bug 686674 — Tracker backend doesn't implement new Backend functions
  17 • Bug 686506 — Make zeitgeist dependency optional again
  18 • Bug 686693 — writing birthday lacks conversion from UTC
  19 • Bug 685401 — linking by email
  20 • Bug 687050 — eds: expose Google system groups in the API
  21 • Bug 686673 — Build error: libsocialweb backend doesn't implement new Backend
  22   functions
  23 • Bug 688834 — getting properties creates data structures over and over again
  24 • Bug 688923 — remove URLs (blog, free/busy, video, home page)
  25 • Bug 689146 — disabling EDS address books does not remove personas
  26 • Bug 689859 — core folks does not depend on telepathy
  27 • Bug 677633 — Cannot delete favourite
  28 • Bug 685992 — empathy strips the "+" (plus) from the numbers from the
  29   gnome-contacts
  30 • Bug 690989 — "warning: copying delegates is discouraged"
  31 • Bug 690990 — Add tests/README
  32 • Bug 690876 — eds: fix various test failures
  33 • Bug 691167 — Build failure: key-file tests built before dependencies
  34 • Bug 686695 — support nickname in add_persona_from_details
  35 • Bug 691382 — Restore tests disabled by bug #668415 (which has been fixed)
  36 • Bug 691923 — Don't rebuild docs on every "make" run
  37 • Bug 692122 — build: Don't use make functions for defining TESTS
  38 • Bug 693435 — eds test: create-remove-stores fails sporadically
  39 • Bug 673918 — Port to newer libgee
  40
  41 API changes:
  42 • Add Backend.enable_persona_store and disable_persona_store.
  43 • Add Backend.set_persona_stores.
  44 • Add IndividualAggregator.new_with_backend_store.
  45 • Add Edsf.PersonaStore.create|remove_address_book.
  46
  47 Overview of changes from libfolks 0.7.4.1 to libfolks 0.8.0
  48 ===========================================================
  49
  50 Major changes:
  51 • Some translation comment and documentation improvements
  52 • Lots of updated translations
  53
  54 Bugs fixed:
  55 • Bug 684014 — A few outstanding issues in the internationalisation
  56 • Bug 683390 — Individuals sometimes not removed when disabling their
  57   Telepathy account
  58 • Bug 672709 — Add new interaction details properties to individuals
  59   (follow-up patch)
  60 • Bug 684954 — Debug message claim that Individual are created with no personas
  61
  62 Overview of changes from libfolks 0.7.4 to libfolks 0.7.4.1
  63 ===========================================================
  64
  65 Fixed so version by bumping the right numbers in configure.ac
  66
  67 Overview of changes from libfolks 0.7.3 to libfolks 0.7.4
  68 =========================================================
  69
  70 Bugs fixed:
  71 • Bug 681346 — Individual id can be inconsistent
  72 • Bug 681420 — warning (vala 0.17.x): access to static class members through an
  73   instance variable
  74 • Bug 664072 — Folks should only use assert*() for critical, program-terminating
  75   errors
  76 • Bug 682572 — Build failures due to accessing static members
  77 • Bug 682346 — build: Make telepathy backend optional
  78 • Bug 682809 — Lazy instantiation of multi-valued properties
  79 • Bug 682719 — eds test fails to compile
  80 • Bug 683319 — Crash in individual-aggregator: _personas_changed_cb
  81 • Bug 681164 — Folks-inspect linking fails
  82 • Bug 680335 — empathy crashed with SIGSEGV in
  83   _tpf_persona_contact_weak_notify_cb()
  84 • Bug 681726 — empathy crashed with SIGABRT in g_assertion_message()
  85 • Bug 683452 — gnome-contacts starts up with an empty address book
  86 • Bug 681476 — folks-inspect could use some methods to set values
  87 • Bug 683390 — Individuals sometimes not removed when disabling their Telepathy account
  88 • Bug 683267 — Warning when starting in non group mode
  89 • Bug 683093 — Crash in
  90   __tpf_persona_store_self_contact_changed_cb_g_object_notify
  91
  92 API changes:
  93 • Add PropertyError.UNAVAILABLE
  94
  95 Overview of changes from libfolks 0.7.2 to libfolks 0.7.3
  96 =========================================================
  97
  98 Bugs fixed:
  99 • Bug 629537 — Support anti-linking
 100 • Bug 679618 — Crash when unsetting all groups
 101 • Bug 678696 — Add API for EDS Google system groups
 102 • Bug 669158 — Readonly/Offline issues
 103 • Bug 675223 — Shouldn't warn if CM does not implement any contact list
 104 • Bug 660128 — Most contacts don't have an avatar
 105 • Bug 652637 — Don't hold locks across async calls
 106 • Bug 660236 — Paging for long text in folks-inspect
 107 • Bug 679116 — Output debug message if modules are not loaded because of mime
 108   type detection
 109 • Bug 657456 — Folks test output not terribly useful
 110 • Bug 674611 — Remove gconf.path once EDS drops GConf
 111
 112 API changes:
 113 • Add AntiLinkable interface and implement it on Kf.Persona and Edsf.Persona
 114 • Add Edsf.Persona.in_google_personal_group
 115 • Add IndividualAggregator.unprepare()
 116
 117 Overview of changes from libfolks 0.7.1 to libfolks 0.7.2
 118 =========================================================
 119
 120 Dependencies:
 121 • evolution-data-server ≥ 3.5.3.1
 122
 123 Bugs fixed:
 124 • Bug 677166 — Salut personas survive disconnection
 125 • Bug 678474 — potential-match should be smarter with accents
 126 • Bug 678781 — memory leak in e-d-s backend
 127 • Bug 678811 — Fix eds backend unit tests
 128 • Bug 678734 — Add profiling API
 129 • Bug 679020 — Fail to build master using vala master
 130
 131 API changes:
 132 • Add profiling api
 133
 134 Overview of changes from libfolks 0.7.0 to libfolks 0.7.1
 135 =========================================================
 136
 137 Dependencies:
 138 • telepathy-glib ≥ 0.17.5
 139 • libzeitgeist ≥ 0.3.14
 140 • evolution-data-server ≥ 3.5.3
 141 • GLib ≥ 2.26.0
 142 • GConf dependency dropped
 143 • intltool ≥ 0.50.0
 144
 145 Bugs fixed:
 146 • Bug 674256 — telepathy-glib minimal version is insufficient
 147 • Bug 647909 — Port Folks to GSettings
 148 • Bug 663890 — @throws annotations missing for some functions
 149 • Bug 675292 — Assertion when joining IRC channel
 150 • Bug 676023 — Invalid read when preparing the aggregator
 151 • Bug 627403 — Move default presence messages from Empathy to libfolks
 152 • Bug 675121 — port Folks to eds api changes
 153 • Bug 672709 — Add new interaction details properties to individuals
 154
 155 API changes:
 156 • Add PresenceDetails.get_default_message_from_type()
 157 • Add new Individual properties:
 158     - im_interaction_count
 159     - call_interaction_count
 160     - last_im_interaction_timestamp
 161     - last_call_interaction_timestamp
 162 • Add InteractionDetails interface to report interactions with Personas and
 163   Individuals
 164
 165 Overview of changes from libfolks 0.6.9 to libfolks 0.7.0
 166 =========================================================
 167
 168 Major changes:
 169 * Folks now uses the Connection.ContactList Telepathy spec. instead of the
 170   deprecated Channel.ContactList. This means legacy Connection Managers
 171   (notably telepathy-butterfly) are not supported any more .
 172
 173 Bugs fixed:
 174 • Bug 658576 — Need API to get a FolksIndividual from his ID
 175 • Bug 671662 — Renamed alias of Facebook contact is not saved
 176 • Bug 630822 — Support Connection.Interface.ContactList API
 177
 178 API changes:
 179 • Add IndividualAggregator.look_up_individual()
 180
 181 Overview of changes from libfolks 0.6.8 to libfolks 0.6.9
 182 =============================================================
 183
 184 Dependencies:
 185 • telepathy-glib ≥ 0.15.5
 186
 187 Bugs fixed:
 188 • Bug 672980 — tp_account_get_protocol: assertion `TP_IS_ACCOUNT (account)' failed
 189
 190 Overview of changes from libfolks 0.6.7 to libfolks 0.6.8
 191 =============================================================
 192
 193 Major changes:
 194 * FOLKS_DEBUG has been removed in favour of G_MESSAGES_DEBUG (and the bug where
 195   folks would set G_MESSAGES_DEBUG for any process linked to it has been fixed)
 196 * A --disable-fatal-warnings configure flag has been added for non-developers
 197 * Update favourite status of EDS contacts with membership of the ‘Starred in
 198   Android’ Google Contacts group
 199 * Improvements to linking suggestions (potential matches)
 200 * Improvements to folks-inspect to make it a good command line citizen
 201
 202 Bugs fixed:
 203 * Bug 670191 — IndividualAggregator::is-quiescent is never set to TRUE
 204 * Bug 670523 — persona.vala:153:folks_persona_get_individual:
 205   assertion failed: (_tmp6_)
 206 * Bug 672381 — invalid uninstantiatable type `<invalid>' in cast to
 207   `FolksIndividual'
 208 * Bug 670347 — Check for null birthday strings
 209 * Bug 661490 — Should mark contacts from the "Starred in Android" group as
 210   Favorites
 211 * Bug 671714 — Fail to add contact to the contact list
 212 * Bug 672373 — folks-import segfaults (Archlinux x86_64)
 213 * Bug 670348 — Handle Telepathy CMs crashing/being invalidated
 214 * Bug 671900 — Folks should not suggest linking contacts from telepathy-salut
 215 * Bug 670872 — Should be less sensitive to accentuated chars
 216 * Bug 669984 — Does not notify when contacts are added to groups
 217 * Bug 660235 — Consistent signal handlers to a terminal would be cool
 218 * Bug 671499 — Don't set G_MESSAGES_DEBUG unconditionally
 219
 220 API changes:
 221 * Add MatchResult.NONE enum member
 222
 223 Overview of changes from libfolks 0.6.6 to libfolks 0.6.7
 224 =============================================================
 225 Bugs fixed:
 226 * Bug 666310 — Crash in Tracker backend by unsetting an entry in a read-only map
 227 * Bug 666528 — Can't convert from type 'GFile' to 'gchararray'
 228 * Bug 666540 — Segfault on empty e-mail addresses with potential match
 229 * Bug 659610 — Support code coverage report generation
 230 * Bug 657063 — Allow to pass a command to folks-inspect
 231 * Bug 667410 — A second instance of the aggregator only fetch a small subset of
 232   my contacts
 233 * Bug 667535 — persona created by tpf_persona_dup_for_contact() outlives its
 234   TpContact
 235 * Bug 670196 — Disable GLib deprecation warnings
 236 * Bug 668415 — Port to Vala 0.15.x
 237
 238 API changes:
 239 * Add PostalAddress.is_empty() and Role.is_empty()
 240
 241 Overview of changes from libfolks 0.6.5 to libfolks 0.6.6
 242 =============================================================
 243 Bugs fixed:
 244 * Bug 664158 — Stale log handler can cause segfault when re-creating Aggregator
 245   in a single run
 246 * Bug 663889 — crash due to NameDetails which fail to guarantee
 247   non-null full-name/nickname
 248 * Bug 665039 — Crash in folks_backends_sw_backend_add_service
 249 * Bug 665728 — TpfPersonaStore: prepare() isn't mutually exclusive inside a
 250   single thread
 251 * Bug 665692 — Use constructors correctly
 252 * Bug 665376 — Add API to get a TpfPersona from a TpContact
 253
 254 API changes:
 255 * Add Edsf.PersonaStore.source
 256 * Make Edsf.Persona.contact writeable on construct (previously private setter)
 257 * Make Edsf.Persona.contact_id writeable on construct (previously private
 258   setter)
 259 * Add Swf.PersonaStore.service
 260 * Make Swf.Persona.lsw_contact writeable on construct (previously private
 261   setter)
 262 * Add Trf.Persona.tracker_id
 263 * Add Trf.Persona.cursor
 264 * Make AbstractFieldDetails.value writeable on construct (previously just a
 265   normal setter)
 266 * Make AbstractFieldDetails.parameters writeable on construct (previously just a
 267   normal setter)
 268 * Add ObjectCache.type_id
 269 * Add ObjectCache.id
 270 * Add Tpf.PersonaStore.dup_for_account() and Tpf.Persona.dup_for_contact()
 271
 272 Overview of changes from libfolks 0.6.4.1 to libfolks 0.6.5
 273 =============================================================
 274 Bugs fixed:
 275 * Bug 662285 — Error with email -> im_addresses when updating a contact
 276 * Bug 662433 — AbstractFieldDetails.equal() is ambiguous about checking
 277   parameters.
 278 * Bug 660908 — Add favourites support to EDS backend
 279 * Bug 662770 — ContactPhotos are ignored when mime type is null
 280 * Bug 662616 — We should set mime type when setting an EContact's photo
 281 * Bug 662274 — Failed to link personas: Can't link personas with no primary
 282   store.
 283 * Bug 662314 — Gnome-shell restarts if I change my user status to
 284   disconnected/unavailable
 285 * Bug 663798 — Add AbstractFieldDetails.value_type
 286 * Bug 659585 — GLib-GIO-CRITICAL **: g_bus_unwatch_name: assertion
 287   `watcher_id > 0' failed
 288
 289 API changes:
 290 * Add AbstractFieldDetails.id to identify instances of details
 291 * Deprecate PostalAddress.uid in favor of AbstractFieldDetails.id
 292 * Deprecate NoteFieldDetails.uid in favor of AbstractFieldDetails.id
 293 * Deprecate Role.uid in favor of AbstractFieldDetails.id
 294 * Add AbstractFieldDetails.values_equal() to compare values (but not parameters)
 295 * Implement FavouriteDetails on Edsf.Persona
 296 * Add AbstractFieldDetails.value_type
 297
 298 Behavior changes:
 299 * PostalAddress.equal() now ignores PostalAddress.uid
 300 * NoteFieldDetails.equal() now ignores NoteFieldDetails.uid
 301
 302 Overview of changes from libfolks 0.6.4 to libfolks 0.6.4.1
 303 =============================================================
 304 Bugs fixed:
 305 * Bug 662095 — so name of libfolks v 0.6.4 is lower than of libfolks v 0.6.3.x
 306
 307 Overview of changes from libfolks 0.6.3.2 to libfolks 0.6.4
 308 =============================================================
 309 Bugs fixed:
 310 * Bug 660217 — folks-0.6.3.2 requires tracker-0.12, but configure.ac calls
 311   VALA_CHECK_PACKAGES([tracker-sparql-0.12])
 312 * Bug 657602 — Telepathy backend fails to set Personas' phone numbers from
 313   ContactInfo
 314 * Bug 660937 — [regression] build failure: No package 'gee-1.0' found
 315 * Bug 661475 — string_strip: assertion `self != NULL' failed
 316
 317 API changes:
 318 * Implement PhoneDetails on Tpf.Persona
 319 * Implement NameDetails on Tpf.Persona
 320 * Implement EmailDetails on Tpf.Persona
 321 * Implement UrlDetails on Tpf.Persona
 322 * Implement BirthdayDetails on Tpf.Persona
 323 * Add PersonaStoreError.UNSUPPORTED_ON_NON_USER
 324
 325 Overview of changes from libfolks 0.6.3.1 to libfolks 0.6.3.2
 326 =============================================================
 327 Bugs fixed:
 328 * Bug 660140 — contacts_contact_find_persona_from_store: assertion `store !=
 329   NULL' failed
 330 * Bug 659041 — tpf-persona-store.vala: try to connect to a NULL object
 331 * Bug 660051 — require tracker 0.12
 332
 333 Overview of changes from libfolks 0.6.3 to libfolks 0.6.3.1
 334 ===========================================================
 335 Bugs fixed:
 336 * Bug 658631 — Deprecate PersonaStore.can-[alias|group]-personas
 337 * Bug 658002 — defective typelib
 338 * Bug 659737 — tests fail due to usage of deprecated methods
 339 * Bug 659732 — Gnome fails to load and crashes when the Evolution-exchange
 340   plugin is configured
 341
 342 API changes:
 343 * Deprecate Folks.PersonaStore.can_[alias, group]_personas.
 344   Applications should use Folks.PersonaStore#always-writeable-properties
 345   and Folks.Persona#writeable-properties to check availability of "alias"
 346   and "groups" properties.
 347
 348 Overview of changes from libfolks 0.6.2.1 to libfolks 0.6.3
 349 ===========================================================
 350
 351 Major changes:
 352 * Cleanup of the definition of “writeable” which involves a couple of API
 353   deprecations and additions, and some internal re-working.
 354 * Beginnings of standardising TYPE values for AbstractFieldDetails
 355
 356 Bugs fixed:
 357 * Bug 658631 — crash at empathy startup
 358 * Bug 658331 — Ensure read-only PersonaStores have empty writeable-properties
 359 * Bug 658874 — Typo?
 360 * Bug 658730 — ngettext (Plural forms) needed for
 361   "Imported %u buddies from '%s'."
 362 * Bug 633781 — Allow to set avatar on individuals
 363 * Bug 657142 — Automatically link e-d-s contacts with their contacts from
 364   telepathy
 365 * Bug 658002 — defective typelib
 366 * Bug 657065 — Cache keeps around contacts from disabled accounts
 367 * Bug 658323 — Deprecate FOLKS_WRITEABLE_STORE in favour of FOLKS_PRIMARY_STORE
 368 * Bug 659095 — Don't distribute typelib file
 369 * Bug 659128 — If a persona store goes away we don't remove its personas
 370 * Bug 657141 — Backend should ask eds for the default backend, not hardcode it
 371 * Bug 658531 — Sometimes avatar caching doesn't work
 372 * Bug 658328 — Return PropertyError.NOT_WRITEABLE from Persona property setters
 373   as appropriate
 374 * Bug 646847 — We should rename _update () in Trf.Persona to something more less
 375   misleading
 376 * Bug 658161 — Consistently use “contact” in translatable strings instead of
 377   “persona”
 378 * Bug 657738 — Favorite people are not always displayed
 379 * Bug 653623 — Would like a set of standard "type" parameters for UrlDetails
 380
 381 API changes:
 382 * Individual.avatar is now settable using Individual.change_avatar() (not new
 383   API, but it no longer always returns an error)
 384 * We now use the FOLKS_PRIMARY_STORE env var instead of FOLKS_WRITEABLE_STORE
 385   to configure the primary store
 386 * Deprecate Folks.PersonaStore.is_writeable
 387 * Add Folks.PersonaStore.is_primary_store
 388 * Add Folks.IndividualAggregatorError.NO_PRIMARY_STORE
 389 * In IndividualAggregator.ensure_individual_property_writeable we now throw
 390   NO_PRIMARY_STORE instead of NO_WRITEABLE_STORE
 391 * Add Folks.PersonaStore.user_set_default
 392 * Add AbstractFieldDetails.PARAM_TYPE, .PARAM_TYPE_HOME, .PARAM_TYPE_WORK,
 393   .PARAM_TYPE_OTHER
 394 * Add UrlFieldDetails.PARAM_TYPE_HOME_PAGE, .PARAM_TYPE_BLOG,
 395   .PARAM_TYPE_PROFILE, .PARAM_TYPE_FTP
 396
 397 Overview of changes from libfolks 0.6.2 to libfolks 0.6.2.1
 398 ===========================================================
 399
 400 Bugs fixed:
 401 * Bug 658580 — Assertion in gee_hash_map_node_iterator_next with folks 0.6.2
 402
 403 Overview of changes from libfolks 0.6.1 to libfolks 0.6.2
 404 =========================================================
 405
 406 Bugs fixed:
 407 * Bug 645056 — TpLowlevel library should have only static public functions
 408 * Bug 653777 — Would be nice to have a helper function to create a writable
 409   persona
 410 * Bug 657635 — Linking personas from different (e-d-s) stores is not working
 411 * Bug 657510 — Add asynchronous property setter methods
 412 * Bug 656184 — Add is-quiescent property
 413 * Bug 657971 — Need BirthdayDetails support in eds backend
 414 * Bug 657789 — Don't claim uneditable eds fields as writable
 415 * Bug 657282 — Add an IndividualAggregator.individuals_changed_detailed signal
 416 * Bug 657969 — Support RoleDetails in eds backend
 417 * Bug 657783 — Prefer data from primary store when picking Individual values
 418 * Bug 658411 — Only emit notifications for linkable properties if they've
 419   actually changed
 420 * Bug 656689 — Re-link personas on linkable properties being changed
 421
 422 API changes:
 423 * Add PersonaStore:always-writeable-properties property
 424 * Add IndividualAggregatorError.PROPERTY_NOT_WRITEABLE error
 425 * Add IndividualAggregator.ensure_individual_property_writeable()
 426 * Add Folks.PropertyError
 427 * Add *Details.change_*() virtual methods
 428 * Add IndividualAggregator:is-quiescent, Backend:is-quiescent and
 429   PersonaStore:is-quiescent
 430 * Add PersonaDetail.GROUPS and PersonaDetail.INVALID
 431 * Add IndividualAggregator.individuals_changed_detailed and deprecate
 432   IndividualAggregator.individuals_changed (but not remove or break it)
 433
 434 Overview of changes from libfolks 0.6.0 to libfolks 0.6.1
 435 =========================================================
 436
 437 Bugs fixed:
 438 * Bug 656659 — Use vcards for postal addresses
 439 * Bug 655374 — Un-break avatar tests
 440 * Bug 657067 — Can't build EDS backend using Vala master
 441 * Bug 657332 — Add linking link-individuals
 442
 443 Overview of changes from libfolks 0.5.2 to libfolks 0.6.0
 444 =========================================================
 445
 446 Bugs fixed:
 447 * Bug 649925 — expose SocialWebClient.Contact in Swf.Persona
 448 * Bug 646244 — Incomplete logic to handle attribute updates in Folks.Individual
 449 * Bug 652463 — Tidy up CLEANFILES
 450 * Bug 652434 — Add ability to run any tests through gdb
 451 * Bug 648071 — Add support for presence status from Telepathy
 452 * Bug 652472 — Handle failure in getting the logger service better
 453 * Bug 629716 — Migrate Folks to GDBus
 454 * Bug 652660 — Make Individual.id more stable and well-defined
 455 * Bug 652449 — Folks.Individual's property getters should be read only
 456 * Bug 653325 — Build system does not complain if trying to build docs without
 457   vala-doc installed
 458 * Bug 653746 — mismatch between hash and equals in Note
 459 * Bug 638281 — Add an EDS backend
 460 * Bug 654509 — Folks master not building
 461 * Bug 652048 — Make nickname writable
 462 * Bug 652425 — Failure codes for removing personas needed in PersonaStoreError
 463 * Bug 645549 — Add a way to get the individual from a persona
 464 * Bug 650422 — Add API for easily checking whether details are writeable
 465 * Bug 655019 — Don't notify twice for nickname changes
 466 * Bug 650414 — Need better APIs to handle image data
 467 * Bug 652643 — Add PersonaStore cache
 468 * Bug 655510 — Make truly-writeable *Details property setters public
 469 * Bug 654907 — The writable store shouldn't be set by type_id
 470 * Bug 655745 — Implement read/write support for gender property
 471 * Bug 649296 — Folks backend files shouldn't begin with "lib"
 472 * Bug 652657 — Allow writing to properties of all personas
 473 * Bug 655008 — Tidy up error handling in eds backend
 474 * Bug 653619 — Add company details
 475 * Bug 653679 — Change PostalAddressDetails.postal_addresses to support
 476   vCard-like arbitrary parameters
 477 * Bug 653680 — Change ImDetails.im_addresses to support vCard-like arbitrary
 478   parameters
 479 * Bug 655917 — Rebase EmailDetails.email_addresses upon an
 480   AbstractFieldDetails-derived class
 481 * Bug 655374 — Un-break avatar tests
 482 * Bug 655919 — Rebase NoteDetails.notes upon an AbstractFieldDetails-derived
 483   class
 484 * Bug 655920 — Rebase PhoneDetails.numbers upon an AbstractFieldDetails-derived
 485   class
 486 * Bug 653682 — Change WebServiceDetails.web_service_addresses to support
 487   vCard-like arbitrary parameters
 488 * Bug 655921 — Change RoleDetails.roles to support vCard-like arbitrary
 489   parameters
 490 * Bug 655922 — Rebase UrlDetails.urls upon an AbstractFieldDetails-derived class
 491 * Bug 648818 — Support the EDS backend being a primary
 492 * Bug 655609 — Implement setter for URLs
 493
 494 API changes:
 495 * Swf.Persona retains and exposes its libsocialweb Contact
 496 * Add a PresenceDetails.presence_status property
 497 * Make NameDetails.nickname settable
 498 * Drop AliasDetails support from Trf.Persona
 499 * Add PersonaStoreError.PERMISSION_DENIED and PersonaStoreError.REMOVE_FAILED
 500 * Change the error domain of PersonaStore.remove_persona() from GLib.Error to
 501   Folks.PersonaStoreError
 502 * Add a Persona.individual property
 503 * Add a Persona.writeable_properties property and implement it in all the
 504   Persona subclasses
 505 * Make BirthdayDetails.calendar_event_id nullable
 506 * Make Folks.Utils public and add Gee structure equality functions
 507 * AvatarDetails.avatar is now of type LoadableIcon?
 508 * Add AvatarCache class
 509 * Add ObjectCache class
 510 * Remove leaked internal PotentialMatch.result_to_string() method
 511 * Add RoleDetails:role property
 512 * Rebase FieldDetails upon AbstractFieldDetails (requiring the use of the
 513   equivalent AbstractFieldDetails functions in place of the FieldDetails ones).
 514 * Add AbstractFieldDetails.equal() and hash() for better matching on structures
 515   which will store derived objects.
 516 * Add parameters as an optional argument for the FieldDetails constructor
 517 * Use PostalAddressFieldDetails for PostalAddressDetails.postal_addresses
 518 * Remove PostalAddress.types (obsoleted by PostalAddressFieldDetails.parameters)
 519 * Add and use ImFieldDetails for ImDetails.im_addresses
 520 * Add and use EmailFieldDetails for EmailFieldDetails.email_addresses
 521 * Add and use NoteFieldDetails for NoteFieldDetails.notes
 522 * Remove Note class (obsoleted by NoteFieldDetails)
 523 * Add and use PhoneFieldDetails for PhoneFieldDetails.phone_numbers
 524 * Remove all PhoneDetails functions (obsoleted by PhoneFieldDetails)
 525 * Add and use WebServiceFieldDetails for
 526   WebServiceFieldDetails.web_service_addresses
 527 * Use RoleFieldDetails for RoleDetails.roles
 528 * Use UrlFieldDetails for UrlDetails.urls
 529
 530 Overview of changes from libfolks 0.5.1 to libfolks 0.5.2
 531 =========================================================
 532
 533 Bugs fixed:
 534 * Bug 650067 — Tracker backend warns when setting a NULL avatar (ie, unsetting
 535   the avatar)
 536 * Bug 650268 — build failure: "--vapidir=.: command not found"
 537
 538 Overview of changes from libfolks 0.5.0 to libfolks 0.5.1
 539 =========================================================
 540
 541 Bugs fixed:
 542 * Bug 645388 — Group channels are leaked
 543 * Bug 647562 — Don't crash on duplicate group channels
 544 * Bug 647121 — Crash in individual_store_contact_sort at
 545   empathy-individual-store.c line 1387
 546 * Bug 645684 — Implement Iterator on LinkedHashSet
 547 * Bug 640092 — Folks should minimize use of GLib.List (including its public API)
 548 * Bug 648161 — Add GObject Introspection Support
 549 * Bug 645186 — Make sure all connect() calls have appropriate disconnect() calls
 550 * Bug 648533 — Add runtime debug signalling
 551 * Bug 649790 — Vala uses the wrong includes
 552 * Bug 649088 — Combining contacts doesn't work with german Umlauts
 553
 554 API changes:
 555 * LinkedHashSet.list_iterator() is now disallowed (causes an assertion failure)
 556 * LinkedHashSet.iterator() now returns a BidirIterator instead of just an
 557   Iterator
 558 * ImDetails.im_addresses is now of type MultiMap<string, string>
 559 * WebServiceDetails.web_service_addresses is now of type
 560   MultiMap<string, string>
 561 * Removed LinkedHashSet in favour of Gee.HashSet
 562 * Backend.persona_stores is now of type Map<string, PersonaStore>
 563 * GroupDetails.groups is now of type Set<string>
 564 * FieldDetails.parameters is now of type MultiMap<string, string>
 565 * FieldDetails.get_parameter_values() now returns type Collection<string>
 566 * FieldDetails.extend_parameters() now takes type MultiMap<string, string>
 567 * PostalAddressDetails.postal_addresses is now of type Set<PostalAddress>
 568 * EmailDetails.email_addresses is now of type Set<FieldDetails>
 569 * PhoneDetails.phone_numbers is now of type Set<FieldDetails>
 570 * UrlDetails.urls is now of type Set<FieldDetails>
 571 * BackendStore.enabled_backends now has type Map<string, Backend>
 572   - The corresponding C function folks_backend_store_dup_enabled_backends()
 573     has been renamed folks_backend_store_get_enabled_backends(), and no longer
 574     returns an owned variable.
 575 * Individual.personas now has type Set<Persona>
 576 * Individual.personas_changed now uses Set<Persona>-typed parameters
 577 * PersonaStore.personas_changed now uses Set<Persona>-typed parameters
 578 * IndividualAggregator.individuals_changed now uses
 579   Set<Individual>-typed parameters
 580 * IndividualAggregator.link_personas() now takes a Set<Persona>
 581 * IndividualAggregator.get_all_potential_matches() now returns a
 582   Map<Individual, Map<Individual, MatchResult>>
 583 * IndividualAggregator.get_potential_matches() now returns a
 584   Map<Individual, MatchResult>
 585 * IndividualAggregator.individuals now has type Map<string, Individual>
 586 * PersonaStore.personas now has type Map<string, Persona>
 587 * LocalIdDetails.local_ids now has type Set<string>
 588 * NoteDetails.notes now has type Set<Note>
 589 * RoleDetails.roles now has type Set<Role>
 590 * PotentialMatch.known_email_aliases now has type Set<string>
 591 * PostalAddress.types now has type Set<string>
 592 * Add Folks.Debug debug controller class
 593 * All pc-files now only add the $includedir to the cflags, so all includes
 594   must be of the form <folks/*.h>
 595
 596 Overview of changes from libfolks 0.4.0 to libfolks 0.5.0
 597 =========================================================
 598
 599 Major changes:
 600 * Add support to change primary (writeable) store either via
 601   GConf or an env variable (bug 645441).
 602 * Bumped Vala dependency to 0.12.0 for bug #646345
 603
 604 Bugs fixed:
 605 * Bug 644968 - _update_phone_numbers() needs to create copies
 606   of each List<FieldDetails>
 607 * Bug 644966 - _update_emails () needs to create copies of each
 608   List<FieldDetails>
 609 * Bug 644527 - Add a Tracker backend
 610 * Bug 645430 - folks-inspect: Use LinkedHashSet to access im-addresses
 611 * Bug 645411 - folks-import segfaults on startup
 612 * Crasher when removing Personas
 613 * Crasher when reconnecting a Telepathy account
 614 * Bug 645680 — Use random integer IDs for Kf.Personas
 615 * Bug 645475 — Linker warnings for Tracker backend tests
 616 * Bug 645570 — Fix checks for empty and equal StructuredNames
 617 * Bug 645989 — Ensure add_persona_from_details handles the basic attribute
 618 * Bug 645413 — Write support for Tracker
 619 * Bug 645441 — Mechanism to specify primary backend
 620 * Bug 638280 — Add a libsocialweb backend
 621 * Deal with duplicated phones/e-mails in Tracker
 622 * Bug 646944 — Fix libsocialweb updates and removals of contacts
 623 * Bug 644867 — add interface for linkable web service contact UIDs
 624 * Bug 647168 — print the "web-service-addresses" property correctly
 625 * Bug 646831 — Setting an existing phone number or e-mail address on a
 626   Trf.Persona fails
 627 * Bug 647298 — folks-inspect gets SIGSEGV when trying to auto-complete
 628   parameters
 629 * Bug 646948 — Support for potential matches
 630
 631 API changes:
 632 * Add equal () to StructuredName
 633 * Add detail_key () along with an enum PersonaDetail to PersonaStore
 634   which together define the basic attributes that should be supported
 635   by add_persona_from_details ().
 636 * Add public primary_store to IndividualAggregator
 637 * Add LocalIdDetails interface for linking Personas based on local address book
 638   IDs (such as for the Tracker backend Personas)
 639 * Add WebServiceDetails interface for linking Personas based on web service
 640   accounts (such as for the libsocialweb backend Personas)
 641 * Add PotentialMatch class and IndividualAggregator.get_potential_matches() and
 642   IndividualAggregator.get_all_potential_matches() to suggest Individuals that
 643   may match the given Individual or all potential matches, respectively.
 644
 645 Overview of changes from libfolks 0.3.6 to libfolks 0.4.0
 646 =========================================================
 647
 648 Bugs fixed:
 649 * Bug 642351 — BACKEND_STORE_KEY_FILE format should support a wildcard entry
 650 * Bug 643241 — _update_urls () needs to create copies of each
 651   List<FieldDetails>
 652 * Bug 643247 — Folks needs C API documentation
 653 * Bug 643201 — folks-inspect can't handle properties which are
 654   List<FieldDetails>
 655 * Bug 642866 — tp-lowlevel leaks TpChannel
 656 * Bug 642861 — FolksLinkedHashSet still alive when exiting Empathy
 657 * Bug 642493 — Folks needs API for specifying a contact's organisation
 658 * Bug 642500 — Folks needs API for specifying a contact's birthday
 659 * Bug 642501 — Folks needs API for attaching notes to a Contact
 660 * Bug 641210 — Add interface for postal addresses
 661 * Bug 643956 — Use the correct signal name for postal addresses
 662 * Bug 643954 — Add to_string () to PostalAddress class
 663 * Bug 643955 — Add to_string () to RoleOwner class
 664 * Bug 643957 — Deal handle birthday and postal-addresses.
 665 * Bug 644457 — Handle structured names
 666 * Bug 644165 — An individual's avatar shouldn't be replaced by a null avatar
 667
 668 API changes:
 669 * Add RoleDetails interface
 670 * Add BirthdayDetails interface
 671 * Add NoteDetails interface
 672 * Add PostalAddressDetails interface
 673 * Rename Aliasable -> AliasDetails
 674 * Rename AvatarOwner -> AvatarDetails
 675 * Rename Emailable -> EmailDetails
 676 * Rename Favouritable -> FavouriteDetails
 677 * Rename GenderOwner -> GenderDetails
 678 * Rename Groupable -> GroupDetails
 679 * Rename IMable -> ImDetails
 680 * Rename NameOwner -> NameDetails
 681 * Rename Phoneable -> PhoneDetails
 682 * Rename PresenceOwner -> PresenceDetails
 683 * Rename Urlable -> UrlDetails
 684
 685 Overview of changes from libfolks 0.3.5 to libfolks 0.3.6
 686 =========================================================
 687
 688 This is just a repackaging of libfolks 0.3.5 with some documentation comment
 689 version numbers fixed.
 690
 691 Overview of changes from libfolks 0.3.4 to libfolks 0.3.5
 692 =========================================================
 693
 694 Major changes:
 695 * Various API breaks and improvements, especially in the IndividualAggregator
 696 * Add various new interfaces: NameOwner, FieldDetails, Urlable, GenderOwner,
 697   Phoneable and Emailable
 698
 699 API changes:
 700 * Add NameOwner interface
 701 * Add FieldDetails interface
 702 * Add Urlable interface
 703 * Add GenderOwner interface
 704 * Add Phoneable interface
 705 * Add Emailable interface
 706 * Add Tpf.Persona.is_in_contact_list
 707 * Rename the URLable interface to Urlable
 708 * Take a PersonaStore in IndividualAggregator.add_persona_from_details
 709 * Remove IndividualAggregatorError.STORE_NOT_FOUND
 710 * Rename the getter for BackendStore.enabled_backends from
 711   folks_backend_store_get_enabled_backends() to
 712   folks_backend_store_dup_enabled_backends()
 713 * Rename BackendStore.get_backend_by_name() to .dup_backend_by_name()
 714
 715 Bugs fixed:
 716 * Bug 640901 — Allow it to be determined whether a user Tpf.Persona is in the
 717   contact list
 718 * Bug 641780 — Incorrect C function names for URLable interface
 719 * Bug 629078 — Folks needs a full API review to take advantage of our
 720   compatibility break in 0.2.x
 721 * Bug 642036 — No way to pass a message when adding a contact
 722
 723 Overview of changes from libfolks 0.3.3 to libfolks 0.3.4
 724 =========================================================
 725
 726 Major changes:
 727 * Add folks-inspect tool
 728 * The use of the new LinkedHashSet type in the API may make libgee a requirement
 729   for some clients (to take full advantage of its class lineage).
 730
 731 API changes:
 732 * New type: LinkedHashSet, similar to Gee.HashSet, but ordered.
 733 * IMable.im_addresses is now a mapping of string to LinkedHashSet.
 734 * Rename the HasAvatar interface to AvatarOwner
 735 * Rename the HasPresence interface to PresenceOwner
 736
 737 Bugs fixed:
 738 * Bug 637240 — libfolks-telepathy.so exports private symbols
 739 * Bug 638311 — Add a HACKING file that outlines development policies and
 740   coding style
 741 * Bug 629083 — Review coding conventions in folks
 742 * Bug 629075 — Add folks command line application
 743 * Bug 638609 — libfolks hard-codes backend names for debugging
 744 * Bug 639195 — Print stack traces for failed tests to improve remote
 745   debugging
 746 * Bug 639113 — Add static aggregation tests
 747 * Bug 639742 — Logger service unavailable in make check
 748 * Bug 640213 — Add tests for LinkedHashSet
 749 * Bug 627397 — Use better interface names
 750
 751 Overview of changes from libfolks 0.3.2 to libfolks 0.3.3
 752 =========================================================
 753
 754 Major changes:
 755 * Fix some minor leaks
 756 * Add support for building gtk-doc documentation for the C API
 757 * Fix some related documentation problems
 758 * Fix some Vala problems caused by differences between Vala 0.10 and 0.12
 759 * Finish off renaming interfaces (this is an API break; see below)
 760 * Don't trust personas from IRC
 761 * Handle invalid IM addresses more gracefully than with an assertion failure
 762 * Fix a linking problem with the user's individual when going offline which
 763   could lead to infinite loops
 764
 765 API changes:
 766 * Rename the Avatar interface to HasAvatar
 767 * Rename the Presence interface to HasPresence
 768 * Rename the Favourite interface to Favouritable
 769 * Add IMableError
 770 * Throw IMableError from IMable.normalise_im_address()
 771
 772 Bugs fixed:
 773 * Bug 635178 — Leak in
 774   folks_tp_lowlevel_connection_open_contact_list_channel_async
 775 * Bug 635649 — autopoint fails to run
 776 * Bug 635703 — Leak in connection_get_requestable_channel_classes_cb
 777 * Bug 635823 — [PATCH] telepathy test not linking against GIO
 778 * Bug 636251 — Fails to add contact
 779 * Bug 629526 — Generate gtk-doc documentation
 780 * Bug 627397 — Use better interface names
 781 * Bug 636714 — Assertion failure on invalid IM address
 782 * Bug 637136 — Infinite loop when disconnecting accounts
 783
 784 Overview of changes from libfolks 0.3.1 to libfolks 0.3.2
 785 ==========================================================
 786
 787 Major changes:
 788 * BackendStore.load_backends() now (un)loads backends which have been
 789   (dis|en)abled since the last call
 790 * FOLKS_BACKEND_DIR has been replaced by FOLKS_BACKEND_PATH. It accepts any
 791   number of files and directories, separated by :
 792 * Significantly clean up the build system
 793
 794 API changes:
 795 * Added BackendStore.prepare() and BackendStore::is-prepared
 796 * Add BackendStore.enable_backend().
 797 * Add BackendStore.disable_backend().
 798 * Add BackendStore.unprepare().
 799 * Remove casting convenience methods on Individual (casting isn't hard)
 800 * Change the visibility of the setters of PersonaStore.type_id,
 801   PersonaStore.display_name, PersonaStore.id, Backend.name,
 802   Backend.persona_stores and Persona.linkable_properties. This removes the
 803   corresponding C setter methods which should never have been exposed
 804 * Remove Tpf.PersonaError
 805 * Remove the exception from the Tpf.Persona constructor
 806
 807 Bugs fixed:
 808 * Bug 629081 — Add API to allow specific backends to be disabled
 809 * Bug 629862 — Add tests for the key-file backend
 810 * Bug 628883 — Add localisation support
 811 * Bug 633718 — Make the Folks releases buildable without vala, valadoc, or
 812   g-i
 813 * Bug 633080 — Crash when disconnecting twice
 814
 815 Overview of changes from libfolks 0.3.0 to libfolks 0.3.1
 816 ==========================================================
 817
 818 Major changes:
 819 * Tpf.Persona.contact is now guaranteed to have the client type feature
 820
 821 API changes:
 822 * Add the PersonaStore:can-add-personas property
 823 * Add the PersonaStore:can-remove-personas property
 824 * Add the PersonaStore:can-alias-personas property
 825 * Add the PersonaStore:can-group-personas property
 826 * Make Individual implement the IMable interface
 827
 828 Bugs fixed:
 829 * Bug 630431 — notify::alias is never emitted
 830 * Bug 631864 — Crash when empathy disconnects
 831 * Bug 632096 — build failure: contact-retrieval.o: undefined reference to
 832   symbol 'gee_abstract_collection_add'
 833 * Bug 632163 — Folks key-file backend needs a way to point to a specific
 834   .ini file
 835 * Bug 632564 — assertion `EMPATHY_IS_CONTACT (contact)' failed in
 836   individual_store_contact_sort
 837
 838 Overview of changes from libfolks 0.1.17 to libfolks 0.3.0
 839 ==========================================================
 840
 841 Major changes:
 842 * Fixed some linking problems
 843 * Added some missing documentation
 844 * Fixed build problems introduced by switching to gobject-introspection 0.9.6
 845   (i.e. GIR format 1.2)
 846 * Bumped telepathy-glib dependency to 0.11.16
 847 * Bumped Vala dependency to 0.10.0
 848 * Bumped gobject-introspection dependency to 0.9.6
 849 * Ensured IM addresses are normalised before being compared
 850 * Made the folks-import build optional through a configure argument
 851 * Added support for a “self” individual
 852 * Added support for generating and installing Devhelp format documentation
 853 * BackendStore.load_backends and the prepare() functions are now idempotent
 854 * Tpf.Persona.contact is now guaranteed to have the avatar token and data
 855   features
 856 * Tpf.Persona.contact is now guaranteed to have the capabilities feature
 857
 858 API changes:
 859 * Added IMable.normalise_im_address()
 860 * Renamed Groups interface to Groupable
 861 * Renamed Alias interface to Aliasable
 862 * Removed BackendStore constructor
 863 * Added BackendStore.dup()
 864 * Added BackendStore::enabled-backends
 865 * Added Individual::is-user
 866 * Added Persona::is-user
 867 * Added IndividualAggregator::user
 868 * Added PersonaStoreError.UNSUPPORTED_ON_USER
 869 * Added {IndividualAggregator, PersonaStoreError}.STORE_OFFLINE, used by the
 870   respective add_persona_from_details() functions
 871
 872 Bugs fixed:
 873 * Bug 629452 — [Patch] Add missing gio linking for import-tool
 874 * Bug 626008 — Add @since lines to all symbols
 875 * Bug 629311 — Folks should normalize IDs written to the writable backend
 876 * Bug 629644 — Key file backend cannot be loaded because of linking problems
 877 * Bug 629666 — libfolks should not hard autodetect libxml
 878 * Bug 628970 — Folks API needs a way to determine whether a specific type of
 879   PersonaStore is available
 880 * Bug 629096 — Add a library init function
 881 * Bug 627402 — Support marking FolksPersonas as "me"
 882 * Bug 629642 — individuals-changed emitted in the wrong order
 883 * Bug 629643 — do not fall back to the id if alias is empty
 884 * Bug 629006 — PersonaStore should gracefully handle offline Persona change
 885   attempts
 886 * Bug 629331 — BackendStore.load_backends and the prepare() functions should
 887   be idempotent.
 888 * Bug 629008 — Add a test for Persona additions
 889 * Bug 630347 — Avatars are always NULL
 890
 891 Overview of changes from libfolks 0.1.16 to libfolks 0.1.17
 892 ===========================================================
 893
 894 Major changes:
 895 * Added a basic test suite
 896 * Cleaned up the build system
 897 * Ensured the public libraries' VAPI files are distributed and installed
 898 * Prevented the key-file from being saved unnecessarily
 899 * Fixed multi-byte character handling in the key-file backend
 900 * Ensured account removal and invalidation is handled in the Telepathy backend
 901 * Prevented a hang when creating relationships.ini in certain situations
 902 * Added a folks-import tool to import meta-contact data from Pidgin; this adds
 903   a dependency on libxml
 904
 905 API changes:
 906 * Added PersonaStore.flush()
 907
 908 Bugs fixed:
 909 * Bug 628930 — folks crahses empathy on relationships.ini read
 910 * Bug 629082 — Empathy crashes when toggling "Ignore SSL certificate errors"
 911   checkbox
 912 * Bug 628853 — hangs if there's no relationships.ini file
 913 * Bug 629084 — Add a folks-import tool
 914
 915 Overview of changes from libfolks 0.1.15 to libfolks 0.1.16
 916 ===========================================================
 917
 918 Major changes:
 919 * Added more debugging output
 920 * Fixed various small outputted code bugs
 921 * Fixed problem where key file groups would be overwritten in some situations
 922 * Fixed various signal emission problems
 923 * Prevented changes to Personas' properties from being propagated back up to the
 924   Individuals
 925 * Limited libgee dependency to < 0.7 due to API changes in libgee
 926 * Added a FOLKS_DISABLE_LINKING environment variable to disable linking (for
 927   debugging purposes)
 928
 929 Bugs fixed:
 930 * Bug 628108 — Favorite contacts are not save any more
 931 * Bug 628294 — Some contacts appear to be linked together while they shouldn't
 932 * Bug 628305 — Signal removal of Individuals containing untrusted Personas
 933 * Bug 628131 — error message when trying to link ICQ with jabber
 934 * Bug 628343 — Add an environment variable to disable linking
 935 * Bug 628335 — Assertion error with master
 936
 937 Overview of changes from libfolks 0.1.14.1 to libfolks 0.1.15
 938 =============================================================
 939
 940 Major changes:
 941 * Fixed various build problems
 942 * Ensured duplicate entries don't appear in various sets
 943 * Made gobject-introspection dependency explicit
 944 * Limited libgee dependency to <= 0.5.2 due to API changes in libgee
 945 * Reworked some of the Individual internals to make notifications more efficient
 946 * Added the concept of an Individual's “trust level”
 947 * Changed alias fallbacks to fall back to a display ID instead of a UID
 948 * Added support for storing aliases in the key-file backend and use them in
 949   preference to aliases from other Personas in an Individual
 950
 951 API changes:
 952 * Added Individual:personas-changed
 953 * Added TrustLevel enum
 954 * Added Individual::trust-level
 955 * Implemented Alias on Kf.Persona
 956
 957 Bugs fixed:
 958 * Bug 627314 — folks cannot be install in gentoo sandbox
 959 * Bug 627506 — Require gobject-introspection
 960 * Bug 626725 — Add an Individual.personas_changed signal
 961 * Bug 627968 — Add Individual.trust_level property
 962 * Bug 626578 — Use vala's vala.m4 to check for telepathy-glib(.vapi)
 963 * Bug 626410 — contacts show up with a weird alias
 964 * Bug 627508 — Store alias and groups in the key-file backend
 965 * Bug 627898 — Fails to install with -j4
 966
 967 Overview of changes from libfolks 0.1.14 to libfolks 0.1.14.1
 968 =============================================================
 969
 970 Major changes:
 971 * Bumped Vala dependency to 0.9.6
 972 * Fixed some more warning spew
 973
 974 Overview of changes from libfolks 0.1.13 to libfolks 0.1.14
 975 ===========================================================
 976
 977 Major changes:
 978 * Changed Vala detection code to use the correct macro
 979 * Bumped Vala dependency to 0.9.5
 980 * Removed some more message spew
 981 * Changed tp-lowlevel Vala bindings to be generated using gobject-introspection
 982 * Added optional dependency on gobject-introspection 0.6.7
 983
 984 Overview of changes from libfolks 0.1.12 to libfolks 0.1.13
 985 ===========================================================
 986
 987 Major changes:
 988 * Added the concept of “linkable properties”
 989 * Added the IMable interface
 990 * Added the concept of persona store “trust”
 991 * Added a writeable key-file backend
 992 * Added linking support to the IndividualAggregator
 993 * Tidied up ID handling in the backends
 994 * Warn if a backend's MIME type could not be determined, notifying the user if
 995   libfolks can't load backends due to shared-mime-info not being installed
 996 * Hint to clients the Individual replacing a removed Individual (if any)
 997 * Exposed Telepathy contacts' IM addresses using the IMable interface
 998 * Fixed some build and dependency issues
 999 * Bumped telepathy-glib dependency to 0.11.11 and dropped dependency on
1000   telepathy-vala
1001 * Added the concept of “writeable” PersonaStores and use this concept to prevent
1002   properties being synchronised between PersonaStores unnecessarily (and
1003   potentially even destructively)
1004
1005 API changes:
1006 * Added Persona::linkable-properties
1007 * Added IMable interface
1008 * Added PersonaStoreTrust enum
1009 * Added PersonaStore::trust-level
1010 * Added Persona.LinkablePropertyCallback()
1011 * Added Persona.linkable_property_to_links()
1012 * Added Persona.build_uid()
1013 * Added Persona.split_uid()
1014 * Added Persona::display-id
1015 * Added PersonaStore::display-name
1016 * Added replacement_individual parameter to Individual:removed
1017 * Implemented IMable on Tpf.Persona
1018 * Added IndividualAggregatorError.NO_WRITEABLE_STORE
1019 * Added IndividualAggregator.link_personas()
1020 * Added IndividualAggregator.unlink_individual()
1021 * Added PersonaStore::is-writeable
1022
1023 Bugs fixed:
1024 * Bug 625830 — Adding an existing contact to the tp backend results in bogus
1025   warnings
1026 * Bug 626108 — Defining XDG_DATA_DIRS prevents backends from being loaded
1027
1028 Overview of changes from libfolks 0.1.11 to libfolks 0.1.12
1029 ===========================================================
1030
1031 Major changes:
1032 * Added debug flags support using the FOLKS_DEBUG environment variable
1033 * Removed various bits of message and warning spew
1034 * Bumped Vala dependency to 0.9.4
1035 * Ensured connections which are ready as soon as they're connected are handled
1036   correctly
1037 * Versioned the installed backends using the main library's libtool version
1038
1039 Bugs fixed:
1040 * Bug 625815 — No contat showed in the contact list
1041
1042 Overview of changes from libfolks 0.1.10 to libfolks 0.1.11
1043 ===========================================================
1044
1045 Major changes:
1046 * Moved various bits of preparation code out into async prepare() methods to
1047   avoid race conditions on startup
1048 * Reset TpfPersonaStore state when going offline
1049 * Made several methods async which could potentially require it in future
1050 * Added error throws to various functions which could potentially fail in future
1051
1052 API changes:
1053 * Added PersonaStore.prepare()
1054 * Added Backend.prepare()
1055 * Removed error thrown from Backend constructor
1056 * Added IndividualAggregator.prepare()
1057 * Changed return type of Presence.is_online() from uint to int
1058 * Made IndividualAggregator.remove_individual() async
1059 * Made PersonaStore.remove_persona() async
1060 * Added an error throw to BackendStore.load_backends()
1061 * Added an error throw to IndividualAggregator.prepare()
1062 * Added an error throw to IndividualAggregator.remove_individual()
1063 * Added an error throw to IndividualAggregator.remove_persona()
1064 * Added an error throw to PersonaStore.remove_persona()
1065 * Made Groups.change_group() async
1066 * Made Groups:group-changed async
1067
1068 Overview of changes from libfolks 0.1.9 to libfolks 0.1.10
1069 ==========================================================
1070
1071 Major changes:
1072 * Fixed various memory and reference leaks
1073 * Lots of build system improvements
1074 * Added a libtool version to the installed libraries
1075
1076 Initial release of libfolks 0.1.9
1077 =================================
1078
1079 Major changes:
1080 * Move to GNOME infrastructure