NEWS

   1 Overview of changes from libfolks 0.3.3 to libfolks 0.3.4
   2 =========================================================
   3
   4 Major changes:
   5 * Add folks-inspect tool
   6
   7 Bugs fixed:
   8 * Bug 637240 — libfolks-telepathy.so exports private symbols
   9 * Bug 638311 — Add a HACKING file that outlines development policies and
  10   coding style
  11 * Bug 629083 — Review coding conventions in folks
  12 * Bug 629075 — Add folks command line application
  13 * Bug 638609 — libfolks hard-codes backend names for debugging
  14 * Bug 639195 — Print stack traces for failed tests to improve remote
  15   debugging
  16
  17 Overview of changes from libfolks 0.3.2 to libfolks 0.3.3
  18 =========================================================
  19
  20 Major changes:
  21 * Fix some minor leaks
  22 * Add support for building gtk-doc documentation for the C API
  23 * Fix some related documentation problems
  24 * Fix some Vala problems caused by differences between Vala 0.10 and 0.12
  25 * Finish off renaming interfaces (this is an API break; see below)
  26 * Don't trust personas from IRC
  27 * Handle invalid IM addresses more gracefully than with an assertion failure
  28 * Fix a linking problem with the user's individual when going offline which
  29   could lead to infinite loops
  30
  31 API changes:
  32 * Rename the Avatar interface to HasAvatar
  33 * Rename the Presence interface to HasPresence
  34 * Rename the Favourite interface to Favouritable
  35 * Add IMableError
  36 * Throw IMableError from IMable.normalise_im_address()
  37
  38 Bugs fixed:
  39 * Bug 635178 — Leak in
  40   folks_tp_lowlevel_connection_open_contact_list_channel_async
  41 * Bug 635649 — autopoint fails to run
  42 * Bug 635703 — Leak in connection_get_requestable_channel_classes_cb
  43 * Bug 635823 — [PATCH] telepathy test not linking against GIO
  44 * Bug 636251 — Fails to add contact
  45 * Bug 629526 — Generate gtk-doc documentation
  46 * Bug 627397 — Use better interface names
  47 * Bug 636714 — Assertion failure on invalid IM address
  48 * Bug 637136 — Infinite loop when disconnecting accounts
  49
  50 Overview of changes from libfolks 0.3.1 to libfolks 0.3.2
  51 ==========================================================
  52
  53 Major changes:
  54 * BackendStore.load_backends() now (un)loads backends which have been
  55   (dis|en)abled since the last call
  56 * FOLKS_BACKEND_DIR has been replaced by FOLKS_BACKEND_PATH. It accepts any
  57   number of files and directories, separated by :
  58 * Significantly clean up the build system
  59
  60 API changes:
  61 * Added BackendStore.prepare() and BackendStore::is-prepared
  62 * Add BackendStore.enable_backend().
  63 * Add BackendStore.disable_backend().
  64 * Add BackendStore.unprepare().
  65 * Remove casting convenience methods on Individual (casting isn't hard)
  66 * Change the visibility of the setters of PersonaStore.type_id,
  67   PersonaStore.display_name, PersonaStore.id, Backend.name,
  68   Backend.persona_stores and Persona.linkable_properties. This removes the
  69   corresponding C setter methods which should never have been exposed
  70 * Remove Tpf.PersonaError
  71 * Remove the exception from the Tpf.Persona constructor
  72
  73 Bugs fixed:
  74 * Bug 629081 — Add API to allow specific backends to be disabled
  75 * Bug 629862 — Add tests for the key-file backend
  76 * Bug 628883 — Add localisation support
  77 * Bug 633718 — Make the Folks releases buildable without vala, valadoc, or
  78   g-i
  79 * Bug 633080 — Crash when disconnecting twice
  80
  81 Overview of changes from libfolks 0.3.0 to libfolks 0.3.1
  82 ==========================================================
  83
  84 Major changes:
  85 * Tpf.Persona.contact is now guaranteed to have the client type feature
  86
  87 API changes:
  88 * Add the PersonaStore:can-add-personas property
  89 * Add the PersonaStore:can-remove-personas property
  90 * Add the PersonaStore:can-alias-personas property
  91 * Add the PersonaStore:can-group-personas property
  92 * Make Individual implement the IMable interface
  93
  94 Bugs fixed:
  95 * Bug 630431 — notify::alias is never emitted
  96 * Bug 631864 — Crash when empathy disconnects
  97 * Bug 632096 — build failure: contact-retrieval.o: undefined reference to
  98   symbol 'gee_abstract_collection_add'
  99 * Bug 632163 — Folks key-file backend needs a way to point to a specific
 100   .ini file
 101 * Bug 632564 — assertion `EMPATHY_IS_CONTACT (contact)' failed in
 102   individual_store_contact_sort
 103
 104 Overview of changes from libfolks 0.1.17 to libfolks 0.3.0
 105 ==========================================================
 106
 107 Major changes:
 108 * Fixed some linking problems
 109 * Added some missing documentation
 110 * Fixed build problems introduced by switching to gobject-introspection 0.9.6
 111   (i.e. GIR format 1.2)
 112 * Bumped telepathy-glib dependency to 0.11.16
 113 * Bumped Vala dependency to 0.10.0
 114 * Bumped gobject-introspection dependency to 0.9.6
 115 * Ensured IM addresses are normalised before being compared
 116 * Made the folks-import build optional through a configure argument
 117 * Added support for a “self” individual
 118 * Added support for generating and installing Devhelp format documentation
 119 * BackendStore.load_backends and the prepare() functions are now idempotent
 120 * Tpf.Persona.contact is now guaranteed to have the avatar token and data
 121   features
 122 * Tpf.Persona.contact is now guaranteed to have the capabilities feature
 123
 124 API changes:
 125 * Added IMable.normalise_im_address()
 126 * Renamed Groups interface to Groupable
 127 * Renamed Alias interface to Aliasable
 128 * Removed BackendStore constructor
 129 * Added BackendStore.dup()
 130 * Added BackendStore::enabled-backends
 131 * Added Individual::is-user
 132 * Added Persona::is-user
 133 * Added IndividualAggregator::user
 134 * Added PersonaStoreError.UNSUPPORTED_ON_USER
 135 * Added {IndividualAggregator, PersonaStoreError}.STORE_OFFLINE, used by the
 136   respective add_persona_from_details() functions
 137
 138 Bugs fixed:
 139 * Bug 629452 — [Patch] Add missing gio linking for import-tool
 140 * Bug 626008 — Add @since lines to all symbols
 141 * Bug 629311 — Folks should normalize IDs written to the writable backend
 142 * Bug 629644 — Key file backend cannot be loaded because of linking problems
 143 * Bug 629666 — libfolks should not hard autodetect libxml
 144 * Bug 628970 — Folks API needs a way to determine whether a specific type of
 145   PersonaStore is available
 146 * Bug 629096 — Add a library init function
 147 * Bug 627402 — Support marking FolksPersonas as "me"
 148 * Bug 629642 — individuals-changed emitted in the wrong order
 149 * Bug 629643 — do not fall back to the id if alias is empty
 150 * Bug 629006 — PersonaStore should gracefully handle offline Persona change
 151   attempts
 152 * Bug 629331 — BackendStore.load_backends and the prepare() functions should
 153   be idempotent.
 154 * Bug 629008 — Add a test for Persona additions
 155 * Bug 630347 — Avatars are always NULL
 156
 157 Overview of changes from libfolks 0.1.16 to libfolks 0.1.17
 158 ===========================================================
 159
 160 Major changes:
 161 * Added a basic test suite
 162 * Cleaned up the build system
 163 * Ensured the public libraries' VAPI files are distributed and installed
 164 * Prevented the key-file from being saved unnecessarily
 165 * Fixed multi-byte character handling in the key-file backend
 166 * Ensured account removal and invalidation is handled in the Telepathy backend
 167 * Prevented a hang when creating relationships.ini in certain situations
 168 * Added a folks-import tool to import meta-contact data from Pidgin; this adds
 169   a dependency on libxml
 170
 171 API changes:
 172 * Added PersonaStore.flush()
 173
 174 Bugs fixed:
 175 * Bug 628930 — folks crahses empathy on relationships.ini read
 176 * Bug 629082 — Empathy crashes when toggling "Ignore SSL certificate errors"
 177   checkbox
 178 * Bug 628853 — hangs if there's no relationships.ini file
 179 * Bug 629084 — Add a folks-import tool
 180
 181 Overview of changes from libfolks 0.1.15 to libfolks 0.1.16
 182 ===========================================================
 183
 184 Major changes:
 185 * Added more debugging output
 186 * Fixed various small outputted code bugs
 187 * Fixed problem where key file groups would be overwritten in some situations
 188 * Fixed various signal emission problems
 189 * Prevented changes to Personas' properties from being propagated back up to the
 190   Individuals
 191 * Limited libgee dependency to < 0.7 due to API changes in libgee
 192 * Added a FOLKS_DISABLE_LINKING environment variable to disable linking (for
 193   debugging purposes)
 194
 195 Bugs fixed:
 196 * Bug 628108 — Favorite contacts are not save any more
 197 * Bug 628294 — Some contacts appear to be linked together while they shouldn't
 198 * Bug 628305 — Signal removal of Individuals containing untrusted Personas
 199 * Bug 628131 — error message when trying to link ICQ with jabber
 200 * Bug 628343 — Add an environment variable to disable linking
 201
 202 Overview of changes from libfolks 0.1.14.1 to libfolks 0.1.15
 203 =============================================================
 204
 205 Major changes:
 206 * Fixed various build problems
 207 * Ensured duplicate entries don't appear in various sets
 208 * Made gobject-introspection dependency explicit
 209 * Limited libgee dependency to <= 0.5.2 due to API changes in libgee
 210 * Reworked some of the Individual internals to make notifications more efficient
 211 * Added the concept of an Individual's “trust level”
 212 * Changed alias fallbacks to fall back to a display ID instead of a UID
 213 * Added support for storing aliases in the key-file backend and use them in
 214   preference to aliases from other Personas in an Individual
 215
 216 API changes:
 217 * Added Individual:personas-changed
 218 * Added TrustLevel enum
 219 * Added Individual::trust-level
 220 * Implemented Alias on Kf.Persona
 221
 222 Bugs fixed:
 223 * Bug 627314 — folks cannot be install in gentoo sandbox
 224 * Bug 627506 — Require gobject-introspection
 225 * Bug 626725 — Add an Individual.personas_changed signal
 226 * Bug 627968 — Add Individual.trust_level property
 227 * Bug 626578 — Use vala's vala.m4 to check for telepathy-glib(.vapi)
 228 * Bug 626410 — contacts show up with a weird alias
 229 * Bug 627508 — Store alias and groups in the key-file backend
 230 * Bug 627898 — Fails to install with -j4
 231
 232 Overview of changes from libfolks 0.1.14 to libfolks 0.1.14.1
 233 =============================================================
 234
 235 Major changes:
 236 * Bumped Vala dependency to 0.9.6
 237 * Fixed some more warning spew
 238
 239 Overview of changes from libfolks 0.1.13 to libfolks 0.1.14
 240 ===========================================================
 241
 242 Major changes:
 243 * Changed Vala detection code to use the correct macro
 244 * Bumped Vala dependency to 0.9.5
 245 * Removed some more message spew
 246 * Changed tp-lowlevel Vala bindings to be generated using gobject-introspection
 247 * Added optional dependency on gobject-introspection 0.6.7
 248
 249 Overview of changes from libfolks 0.1.12 to libfolks 0.1.13
 250 ===========================================================
 251
 252 Major changes:
 253 * Added the concept of “linkable properties”
 254 * Added the IMable interface
 255 * Added the concept of persona store “trust”
 256 * Added a writeable key-file backend
 257 * Added linking support to the IndividualAggregator
 258 * Tidied up ID handling in the backends
 259 * Warn if a backend's MIME type could not be determined, notifying the user if
 260   libfolks can't load backends due to shared-mime-info not being installed
 261 * Hint to clients the Individual replacing a removed Individual (if any)
 262 * Exposed Telepathy contacts' IM addresses using the IMable interface
 263 * Fixed some build and dependency issues
 264 * Bumped telepathy-glib dependency to 0.11.11 and dropped dependency on
 265   telepathy-vala
 266 * Added the concept of “writeable” PersonaStores and use this concept to prevent
 267   properties being synchronised between PersonaStores unnecessarily (and
 268   potentially even destructively)
 269
 270 API changes:
 271 * Added Persona::linkable-properties
 272 * Added IMable interface
 273 * Added PersonaStoreTrust enum
 274 * Added PersonaStore::trust-level
 275 * Added Persona.LinkablePropertyCallback()
 276 * Added Persona.linkable_property_to_links()
 277 * Added Persona.build_uid()
 278 * Added Persona.split_uid()
 279 * Added Persona::display-id
 280 * Added PersonaStore::display-name
 281 * Added replacement_individual parameter to Individual:removed
 282 * Implemented IMable on Tpf.Persona
 283 * Added IndividualAggregatorError.NO_WRITEABLE_STORE
 284 * Added IndividualAggregator.link_personas()
 285 * Added IndividualAggregator.unlink_individual()
 286 * Added PersonaStore::is-writeable
 287
 288 Bugs fixed:
 289 * Bug 625830 — Adding an existing contact to the tp backend results in bogus
 290   warnings
 291 * Bug 626108 — Defining XDG_DATA_DIRS prevents backends from being loaded
 292
 293 Overview of changes from libfolks 0.1.11 to libfolks 0.1.12
 294 ===========================================================
 295
 296 Major changes:
 297 * Added debug flags support using the FOLKS_DEBUG environment variable
 298 * Removed various bits of message and warning spew
 299 * Bumped Vala dependency to 0.9.4
 300 * Ensured connections which are ready as soon as they're connected are handled
 301   correctly
 302 * Versioned the installed backends using the main library's libtool version
 303
 304 Bugs fixed:
 305 * Bug 625815 — No contat showed in the contact list
 306
 307 Overview of changes from libfolks 0.1.10 to libfolks 0.1.11
 308 ===========================================================
 309
 310 Major changes:
 311 * Moved various bits of preparation code out into async prepare() methods to
 312   avoid race conditions on startup
 313 * Reset TpfPersonaStore state when going offline
 314 * Made several methods async which could potentially require it in future
 315 * Added error throws to various functions which could potentially fail in future
 316
 317 API changes:
 318 * Added PersonaStore.prepare()
 319 * Added Backend.prepare()
 320 * Removed error thrown from Backend constructor
 321 * Added IndividualAggregator.prepare()
 322 * Changed return type of Presence.is_online() from uint to int
 323 * Made IndividualAggregator.remove_individual() async
 324 * Made PersonaStore.remove_persona() async
 325 * Added an error throw to BackendStore.load_backends()
 326 * Added an error throw to IndividualAggregator.prepare()
 327 * Added an error throw to IndividualAggregator.remove_individual()
 328 * Added an error throw to IndividualAggregator.remove_persona()
 329 * Added an error throw to PersonaStore.remove_persona()
 330 * Made Groups.change_group() async
 331 * Made Groups:group-changed async
 332
 333 Overview of changes from libfolks 0.1.9 to libfolks 0.1.10
 334 ==========================================================
 335
 336 Major changes:
 337 * Fixed various memory and reference leaks
 338 * Lots of build system improvements
 339 * Added a libtool version to the installed libraries
 340
 341 Initial release of libfolks 0.1.9
 342 =================================
 343
 344 Major changes:
 345 * Move to GNOME infrastructure