NEWS

   1 Overview of changes from libfolks 0.5.0 to libfolks 0.5.1
   2 =========================================================
   3
   4 Bugs fixed:
   5 * Bug 645388 — Group channels are leaked
   6 * Bug 647562 — Don't crash on duplicate group channels
   7 * Bug 647121 — Crash in individual_store_contact_sort at
   8   empathy-individual-store.c line 1387
   9 * Bug 645684 — Implement Iterator on LinkedHashSet
  10
  11 API changes:
  12 * LinkedHashSet.list_iterator() is now disallowed (causes an assertion failure)
  13 * LinkedHashSet.iterator() now returns a BidirIterator instead of just an
  14   Iterator
  15 * ImDetails.im_addresses is now of type MultiMap<string, string>
  16 * WebServiceDetails.web_service_addresses is now of type
  17   MultiMap<string, string>
  18 * Removed LinkedHashSet in favour of Gee.HashSet
  19 * Backend.persona_stores is now of type Map<string, PersonaStore>
  20 * GroupDetails.groups is now of type Set<string>
  21 * FieldDetails.parameters is now of type MultiMap<string, string>
  22 * FieldDetails.get_parameter_values() now returns type Collection<string>
  23 * FieldDetails.extend_parameters() now takes type MultiMap<string, string>
  24 * PostalAddressDetails.postal_addresses is now of type Set<PostalAddress>
  25 * EmailDetails.email_addresses is now of type Set<FieldDetails>
  26 * PhoneDetails.phone_numbers is now of type Set<FieldDetails>
  27
  28 Overview of changes from libfolks 0.4.0 to libfolks 0.5.0
  29 =========================================================
  30
  31 Major changes:
  32 * Add support to change primary (writeable) store either via
  33   GConf or an env variable (bug 645441).
  34 * Bumped Vala dependency to 0.12.0 for bug #646345
  35
  36 Bugs fixed:
  37 * Bug 644968 - _update_phone_numbers() needs to create copies
  38   of each List<FieldDetails>
  39 * Bug 644966 - _update_emails () needs to create copies of each
  40   List<FieldDetails>
  41 * Bug 644527 - Add a Tracker backend
  42 * Bug 645430 - folks-inspect: Use LinkedHashSet to access im-addresses
  43 * Bug 645411 - folks-import segfaults on startup
  44 * Crasher when removing Personas
  45 * Crasher when reconnecting a Telepathy account
  46 * Bug 645680 — Use random integer IDs for Kf.Personas
  47 * Bug 645475 — Linker warnings for Tracker backend tests
  48 * Bug 645570 — Fix checks for empty and equal StructuredNames
  49 * Bug 645989 — Ensure add_persona_from_details handles the basic attribute
  50 * Bug 645413 — Write support for Tracker
  51 * Bug 645441 — Mechanism to specify primary backend
  52 * Bug 638280 — Add a libsocialweb backend
  53 * Deal with duplicated phones/e-mails in Tracker
  54 * Bug 646944 — Fix libsocialweb updates and removals of contacts
  55 * Bug 644867 — add interface for linkable web service contact UIDs
  56 * Bug 647168 — print the "web-service-addresses" property correctly
  57 * Bug 646831 — Setting an existing phone number or e-mail address on a
  58   Trf.Persona fails
  59 * Bug 647298 — folks-inspect gets SIGSEGV when trying to auto-complete
  60   parameters
  61 * Bug 646948 — Support for potential matches
  62
  63 API changes:
  64 * Add equal () to StructuredName
  65 * Add detail_key () along with an enum PersonaDetail to PersonaStore
  66   which together define the basic attributes that should be supported
  67   by add_persona_from_details ().
  68 * Add public primary_store to IndividualAggregator
  69 * Add LocalIdDetails interface for linking Personas based on local address book
  70   IDs (such as for the Tracker backend Personas)
  71 * Add WebServiceDetails interface for linking Personas based on web service
  72   accounts (such as for the libsocialweb backend Personas)
  73 * Add PotentialMatch class and IndividualAggregator.get_potential_matches() and
  74   IndividualAggregator.get_all_potential_matches() to suggest Individuals that
  75   may match the given Individual or all potential matches, respectively.
  76
  77 Overview of changes from libfolks 0.3.6 to libfolks 0.4.0
  78 =========================================================
  79
  80 Bugs fixed:
  81 * Bug 642351 — BACKEND_STORE_KEY_FILE format should support a wildcard entry
  82 * Bug 643241 — _update_urls () needs to create copies of each
  83   List<FieldDetails>
  84 * Bug 643247 — Folks needs C API documentation
  85 * Bug 643201 — folks-inspect can't handle properties which are
  86   List<FieldDetails>
  87 * Bug 642866 — tp-lowlevel leaks TpChannel
  88 * Bug 642861 — FolksLinkedHashSet still alive when exiting Empathy
  89 * Bug 642493 — Folks needs API for specifying a contact's organisation
  90 * Bug 642500 — Folks needs API for specifying a contact's birthday
  91 * Bug 642501 — Folks needs API for attaching notes to a Contact
  92 * Bug 641210 — Add interface for postal addresses
  93 * Bug 643956 — Use the correct signal name for postal addresses
  94 * Bug 643954 — Add to_string () to PostalAddress class
  95 * Bug 643955 — Add to_string () to RoleOwner class
  96 * Bug 643957 — Deal handle birthday and postal-addresses.
  97 * Bug 644457 — Handle structured names
  98 * Bug 644165 — An individual's avatar shouldn't be replaced by a null avatar
  99
 100 API changes:
 101 * Add RoleDetails interface
 102 * Add BirthdayDetails interface
 103 * Add NoteDetails interface
 104 * Add PostalAddressDetails interface
 105 * Rename Aliasable -> AliasDetails
 106 * Rename AvatarOwner -> AvatarDetails
 107 * Rename Emailable -> EmailDetails
 108 * Rename Favouritable -> FavouriteDetails
 109 * Rename GenderOwner -> GenderDetails
 110 * Rename Groupable -> GroupDetails
 111 * Rename IMable -> ImDetails
 112 * Rename NameOwner -> NameDetails
 113 * Rename Phoneable -> PhoneDetails
 114 * Rename PresenceOwner -> PresenceDetails
 115 * Rename Urlable -> UrlDetails
 116
 117 Overview of changes from libfolks 0.3.5 to libfolks 0.3.6
 118 =========================================================
 119
 120 This is just a repackaging of libfolks 0.3.5 with some documentation comment
 121 version numbers fixed.
 122
 123 Overview of changes from libfolks 0.3.4 to libfolks 0.3.5
 124 =========================================================
 125
 126 Major changes:
 127 * Various API breaks and improvements, especially in the IndividualAggregator
 128 * Add various new interfaces: NameOwner, FieldDetails, Urlable, GenderOwner,
 129   Phoneable and Emailable
 130
 131 API changes:
 132 * Add NameOwner interface
 133 * Add FieldDetails interface
 134 * Add Urlable interface
 135 * Add GenderOwner interface
 136 * Add Phoneable interface
 137 * Add Emailable interface
 138 * Add Tpf.Persona.is_in_contact_list
 139 * Rename the URLable interface to Urlable
 140 * Take a PersonaStore in IndividualAggregator.add_persona_from_details
 141 * Remove IndividualAggregatorError.STORE_NOT_FOUND
 142 * Rename the getter for BackendStore.enabled_backends from
 143   folks_backend_store_get_enabled_backends() to
 144   folks_backend_store_dup_enabled_backends()
 145 * Rename BackendStore.get_backend_by_name() to .dup_backend_by_name()
 146
 147 Bugs fixed:
 148 * Bug 640901 — Allow it to be determined whether a user Tpf.Persona is in the
 149   contact list
 150 * Bug 641780 — Incorrect C function names for URLable interface
 151 * Bug 629078 — Folks needs a full API review to take advantage of our
 152   compatibility break in 0.2.x
 153 * Bug 642036 — No way to pass a message when adding a contact
 154
 155 Overview of changes from libfolks 0.3.3 to libfolks 0.3.4
 156 =========================================================
 157
 158 Major changes:
 159 * Add folks-inspect tool
 160 * The use of the new LinkedHashSet type in the API may make libgee a requirement
 161   for some clients (to take full advantage of its class lineage).
 162
 163 API changes:
 164 * New type: LinkedHashSet, similar to Gee.HashSet, but ordered.
 165 * IMable.im_addresses is now a mapping of string to LinkedHashSet.
 166 * Rename the HasAvatar interface to AvatarOwner
 167 * Rename the HasPresence interface to PresenceOwner
 168
 169 Bugs fixed:
 170 * Bug 637240 — libfolks-telepathy.so exports private symbols
 171 * Bug 638311 — Add a HACKING file that outlines development policies and
 172   coding style
 173 * Bug 629083 — Review coding conventions in folks
 174 * Bug 629075 — Add folks command line application
 175 * Bug 638609 — libfolks hard-codes backend names for debugging
 176 * Bug 639195 — Print stack traces for failed tests to improve remote
 177   debugging
 178 * Bug 639113 — Add static aggregation tests
 179 * Bug 639742 — Logger service unavailable in make check
 180 * Bug 640213 — Add tests for LinkedHashSet
 181 * Bug 627397 — Use better interface names
 182
 183 Overview of changes from libfolks 0.3.2 to libfolks 0.3.3
 184 =========================================================
 185
 186 Major changes:
 187 * Fix some minor leaks
 188 * Add support for building gtk-doc documentation for the C API
 189 * Fix some related documentation problems
 190 * Fix some Vala problems caused by differences between Vala 0.10 and 0.12
 191 * Finish off renaming interfaces (this is an API break; see below)
 192 * Don't trust personas from IRC
 193 * Handle invalid IM addresses more gracefully than with an assertion failure
 194 * Fix a linking problem with the user's individual when going offline which
 195   could lead to infinite loops
 196
 197 API changes:
 198 * Rename the Avatar interface to HasAvatar
 199 * Rename the Presence interface to HasPresence
 200 * Rename the Favourite interface to Favouritable
 201 * Add IMableError
 202 * Throw IMableError from IMable.normalise_im_address()
 203
 204 Bugs fixed:
 205 * Bug 635178 — Leak in
 206   folks_tp_lowlevel_connection_open_contact_list_channel_async
 207 * Bug 635649 — autopoint fails to run
 208 * Bug 635703 — Leak in connection_get_requestable_channel_classes_cb
 209 * Bug 635823 — [PATCH] telepathy test not linking against GIO
 210 * Bug 636251 — Fails to add contact
 211 * Bug 629526 — Generate gtk-doc documentation
 212 * Bug 627397 — Use better interface names
 213 * Bug 636714 — Assertion failure on invalid IM address
 214 * Bug 637136 — Infinite loop when disconnecting accounts
 215
 216 Overview of changes from libfolks 0.3.1 to libfolks 0.3.2
 217 ==========================================================
 218
 219 Major changes:
 220 * BackendStore.load_backends() now (un)loads backends which have been
 221   (dis|en)abled since the last call
 222 * FOLKS_BACKEND_DIR has been replaced by FOLKS_BACKEND_PATH. It accepts any
 223   number of files and directories, separated by :
 224 * Significantly clean up the build system
 225
 226 API changes:
 227 * Added BackendStore.prepare() and BackendStore::is-prepared
 228 * Add BackendStore.enable_backend().
 229 * Add BackendStore.disable_backend().
 230 * Add BackendStore.unprepare().
 231 * Remove casting convenience methods on Individual (casting isn't hard)
 232 * Change the visibility of the setters of PersonaStore.type_id,
 233   PersonaStore.display_name, PersonaStore.id, Backend.name,
 234   Backend.persona_stores and Persona.linkable_properties. This removes the
 235   corresponding C setter methods which should never have been exposed
 236 * Remove Tpf.PersonaError
 237 * Remove the exception from the Tpf.Persona constructor
 238
 239 Bugs fixed:
 240 * Bug 629081 — Add API to allow specific backends to be disabled
 241 * Bug 629862 — Add tests for the key-file backend
 242 * Bug 628883 — Add localisation support
 243 * Bug 633718 — Make the Folks releases buildable without vala, valadoc, or
 244   g-i
 245 * Bug 633080 — Crash when disconnecting twice
 246
 247 Overview of changes from libfolks 0.3.0 to libfolks 0.3.1
 248 ==========================================================
 249
 250 Major changes:
 251 * Tpf.Persona.contact is now guaranteed to have the client type feature
 252
 253 API changes:
 254 * Add the PersonaStore:can-add-personas property
 255 * Add the PersonaStore:can-remove-personas property
 256 * Add the PersonaStore:can-alias-personas property
 257 * Add the PersonaStore:can-group-personas property
 258 * Make Individual implement the IMable interface
 259
 260 Bugs fixed:
 261 * Bug 630431 — notify::alias is never emitted
 262 * Bug 631864 — Crash when empathy disconnects
 263 * Bug 632096 — build failure: contact-retrieval.o: undefined reference to
 264   symbol 'gee_abstract_collection_add'
 265 * Bug 632163 — Folks key-file backend needs a way to point to a specific
 266   .ini file
 267 * Bug 632564 — assertion `EMPATHY_IS_CONTACT (contact)' failed in
 268   individual_store_contact_sort
 269
 270 Overview of changes from libfolks 0.1.17 to libfolks 0.3.0
 271 ==========================================================
 272
 273 Major changes:
 274 * Fixed some linking problems
 275 * Added some missing documentation
 276 * Fixed build problems introduced by switching to gobject-introspection 0.9.6
 277   (i.e. GIR format 1.2)
 278 * Bumped telepathy-glib dependency to 0.11.16
 279 * Bumped Vala dependency to 0.10.0
 280 * Bumped gobject-introspection dependency to 0.9.6
 281 * Ensured IM addresses are normalised before being compared
 282 * Made the folks-import build optional through a configure argument
 283 * Added support for a “self” individual
 284 * Added support for generating and installing Devhelp format documentation
 285 * BackendStore.load_backends and the prepare() functions are now idempotent
 286 * Tpf.Persona.contact is now guaranteed to have the avatar token and data
 287   features
 288 * Tpf.Persona.contact is now guaranteed to have the capabilities feature
 289
 290 API changes:
 291 * Added IMable.normalise_im_address()
 292 * Renamed Groups interface to Groupable
 293 * Renamed Alias interface to Aliasable
 294 * Removed BackendStore constructor
 295 * Added BackendStore.dup()
 296 * Added BackendStore::enabled-backends
 297 * Added Individual::is-user
 298 * Added Persona::is-user
 299 * Added IndividualAggregator::user
 300 * Added PersonaStoreError.UNSUPPORTED_ON_USER
 301 * Added {IndividualAggregator, PersonaStoreError}.STORE_OFFLINE, used by the
 302   respective add_persona_from_details() functions
 303
 304 Bugs fixed:
 305 * Bug 629452 — [Patch] Add missing gio linking for import-tool
 306 * Bug 626008 — Add @since lines to all symbols
 307 * Bug 629311 — Folks should normalize IDs written to the writable backend
 308 * Bug 629644 — Key file backend cannot be loaded because of linking problems
 309 * Bug 629666 — libfolks should not hard autodetect libxml
 310 * Bug 628970 — Folks API needs a way to determine whether a specific type of
 311   PersonaStore is available
 312 * Bug 629096 — Add a library init function
 313 * Bug 627402 — Support marking FolksPersonas as "me"
 314 * Bug 629642 — individuals-changed emitted in the wrong order
 315 * Bug 629643 — do not fall back to the id if alias is empty
 316 * Bug 629006 — PersonaStore should gracefully handle offline Persona change
 317   attempts
 318 * Bug 629331 — BackendStore.load_backends and the prepare() functions should
 319   be idempotent.
 320 * Bug 629008 — Add a test for Persona additions
 321 * Bug 630347 — Avatars are always NULL
 322
 323 Overview of changes from libfolks 0.1.16 to libfolks 0.1.17
 324 ===========================================================
 325
 326 Major changes:
 327 * Added a basic test suite
 328 * Cleaned up the build system
 329 * Ensured the public libraries' VAPI files are distributed and installed
 330 * Prevented the key-file from being saved unnecessarily
 331 * Fixed multi-byte character handling in the key-file backend
 332 * Ensured account removal and invalidation is handled in the Telepathy backend
 333 * Prevented a hang when creating relationships.ini in certain situations
 334 * Added a folks-import tool to import meta-contact data from Pidgin; this adds
 335   a dependency on libxml
 336
 337 API changes:
 338 * Added PersonaStore.flush()
 339
 340 Bugs fixed:
 341 * Bug 628930 — folks crahses empathy on relationships.ini read
 342 * Bug 629082 — Empathy crashes when toggling "Ignore SSL certificate errors"
 343   checkbox
 344 * Bug 628853 — hangs if there's no relationships.ini file
 345 * Bug 629084 — Add a folks-import tool
 346
 347 Overview of changes from libfolks 0.1.15 to libfolks 0.1.16
 348 ===========================================================
 349
 350 Major changes:
 351 * Added more debugging output
 352 * Fixed various small outputted code bugs
 353 * Fixed problem where key file groups would be overwritten in some situations
 354 * Fixed various signal emission problems
 355 * Prevented changes to Personas' properties from being propagated back up to the
 356   Individuals
 357 * Limited libgee dependency to < 0.7 due to API changes in libgee
 358 * Added a FOLKS_DISABLE_LINKING environment variable to disable linking (for
 359   debugging purposes)
 360
 361 Bugs fixed:
 362 * Bug 628108 — Favorite contacts are not save any more
 363 * Bug 628294 — Some contacts appear to be linked together while they shouldn't
 364 * Bug 628305 — Signal removal of Individuals containing untrusted Personas
 365 * Bug 628131 — error message when trying to link ICQ with jabber
 366 * Bug 628343 — Add an environment variable to disable linking
 367 * Bug 628335 — Assertion error with master
 368
 369 Overview of changes from libfolks 0.1.14.1 to libfolks 0.1.15
 370 =============================================================
 371
 372 Major changes:
 373 * Fixed various build problems
 374 * Ensured duplicate entries don't appear in various sets
 375 * Made gobject-introspection dependency explicit
 376 * Limited libgee dependency to <= 0.5.2 due to API changes in libgee
 377 * Reworked some of the Individual internals to make notifications more efficient
 378 * Added the concept of an Individual's “trust level”
 379 * Changed alias fallbacks to fall back to a display ID instead of a UID
 380 * Added support for storing aliases in the key-file backend and use them in
 381   preference to aliases from other Personas in an Individual
 382
 383 API changes:
 384 * Added Individual:personas-changed
 385 * Added TrustLevel enum
 386 * Added Individual::trust-level
 387 * Implemented Alias on Kf.Persona
 388
 389 Bugs fixed:
 390 * Bug 627314 — folks cannot be install in gentoo sandbox
 391 * Bug 627506 — Require gobject-introspection
 392 * Bug 626725 — Add an Individual.personas_changed signal
 393 * Bug 627968 — Add Individual.trust_level property
 394 * Bug 626578 — Use vala's vala.m4 to check for telepathy-glib(.vapi)
 395 * Bug 626410 — contacts show up with a weird alias
 396 * Bug 627508 — Store alias and groups in the key-file backend
 397 * Bug 627898 — Fails to install with -j4
 398
 399 Overview of changes from libfolks 0.1.14 to libfolks 0.1.14.1
 400 =============================================================
 401
 402 Major changes:
 403 * Bumped Vala dependency to 0.9.6
 404 * Fixed some more warning spew
 405
 406 Overview of changes from libfolks 0.1.13 to libfolks 0.1.14
 407 ===========================================================
 408
 409 Major changes:
 410 * Changed Vala detection code to use the correct macro
 411 * Bumped Vala dependency to 0.9.5
 412 * Removed some more message spew
 413 * Changed tp-lowlevel Vala bindings to be generated using gobject-introspection
 414 * Added optional dependency on gobject-introspection 0.6.7
 415
 416 Overview of changes from libfolks 0.1.12 to libfolks 0.1.13
 417 ===========================================================
 418
 419 Major changes:
 420 * Added the concept of “linkable properties”
 421 * Added the IMable interface
 422 * Added the concept of persona store “trust”
 423 * Added a writeable key-file backend
 424 * Added linking support to the IndividualAggregator
 425 * Tidied up ID handling in the backends
 426 * Warn if a backend's MIME type could not be determined, notifying the user if
 427   libfolks can't load backends due to shared-mime-info not being installed
 428 * Hint to clients the Individual replacing a removed Individual (if any)
 429 * Exposed Telepathy contacts' IM addresses using the IMable interface
 430 * Fixed some build and dependency issues
 431 * Bumped telepathy-glib dependency to 0.11.11 and dropped dependency on
 432   telepathy-vala
 433 * Added the concept of “writeable” PersonaStores and use this concept to prevent
 434   properties being synchronised between PersonaStores unnecessarily (and
 435   potentially even destructively)
 436
 437 API changes:
 438 * Added Persona::linkable-properties
 439 * Added IMable interface
 440 * Added PersonaStoreTrust enum
 441 * Added PersonaStore::trust-level
 442 * Added Persona.LinkablePropertyCallback()
 443 * Added Persona.linkable_property_to_links()
 444 * Added Persona.build_uid()
 445 * Added Persona.split_uid()
 446 * Added Persona::display-id
 447 * Added PersonaStore::display-name
 448 * Added replacement_individual parameter to Individual:removed
 449 * Implemented IMable on Tpf.Persona
 450 * Added IndividualAggregatorError.NO_WRITEABLE_STORE
 451 * Added IndividualAggregator.link_personas()
 452 * Added IndividualAggregator.unlink_individual()
 453 * Added PersonaStore::is-writeable
 454
 455 Bugs fixed:
 456 * Bug 625830 — Adding an existing contact to the tp backend results in bogus
 457   warnings
 458 * Bug 626108 — Defining XDG_DATA_DIRS prevents backends from being loaded
 459
 460 Overview of changes from libfolks 0.1.11 to libfolks 0.1.12
 461 ===========================================================
 462
 463 Major changes:
 464 * Added debug flags support using the FOLKS_DEBUG environment variable
 465 * Removed various bits of message and warning spew
 466 * Bumped Vala dependency to 0.9.4
 467 * Ensured connections which are ready as soon as they're connected are handled
 468   correctly
 469 * Versioned the installed backends using the main library's libtool version
 470
 471 Bugs fixed:
 472 * Bug 625815 — No contat showed in the contact list
 473
 474 Overview of changes from libfolks 0.1.10 to libfolks 0.1.11
 475 ===========================================================
 476
 477 Major changes:
 478 * Moved various bits of preparation code out into async prepare() methods to
 479   avoid race conditions on startup
 480 * Reset TpfPersonaStore state when going offline
 481 * Made several methods async which could potentially require it in future
 482 * Added error throws to various functions which could potentially fail in future
 483
 484 API changes:
 485 * Added PersonaStore.prepare()
 486 * Added Backend.prepare()
 487 * Removed error thrown from Backend constructor
 488 * Added IndividualAggregator.prepare()
 489 * Changed return type of Presence.is_online() from uint to int
 490 * Made IndividualAggregator.remove_individual() async
 491 * Made PersonaStore.remove_persona() async
 492 * Added an error throw to BackendStore.load_backends()
 493 * Added an error throw to IndividualAggregator.prepare()
 494 * Added an error throw to IndividualAggregator.remove_individual()
 495 * Added an error throw to IndividualAggregator.remove_persona()
 496 * Added an error throw to PersonaStore.remove_persona()
 497 * Made Groups.change_group() async
 498 * Made Groups:group-changed async
 499
 500 Overview of changes from libfolks 0.1.9 to libfolks 0.1.10
 501 ==========================================================
 502
 503 Major changes:
 504 * Fixed various memory and reference leaks
 505 * Lots of build system improvements
 506 * Added a libtool version to the installed libraries
 507
 508 Initial release of libfolks 0.1.9
 509 =================================
 510
 511 Major changes:
 512 * Move to GNOME infrastructure