Re: [Tracker] Team conclusions on IRC, DBus API versioning

[Philip Van Hoof <spam pvanhoof be>]

This has been pushed to master.

Happy 'fixing your code' days!

On Wed, 2009-08-05 at 15:37 +0200, Philip Van Hoof wrote:
> During several IRC discussions we as a team decided to version the DBus
> API of Tracker's master.
>
> o. We decided to decouple the API version from the major version
>
> o. We decided that we'd do this in a branch so that people can test
>    their softwares against it, before we merge master with it
>
> o. We decided to use 1 as the first API version, giving this schema:
>
> Service   :  org.freedesktop.Tracker1
> Interface :  org.freedesktop.Tracker1.Resources
> Path      :   /org/freedesktop/Tracker1/Resources
>
>
> The branch where this is implemented can be found here:
> http://git.gnome.org/cgit/tracker/commit/?h=dbus-version
>
>
> o. I decided not to rename the .service files, so they are still called
>    org.freedesktop.Tracker.service. For now this means that it's not
>    easy to install multiple releases of Tracker in parallel. This might
>    change in near future and in the branch.
>
> o. I decided to rename the miner's and the extractor's internal DBus
>    APIs too
>
> o. I decided to rename the Evolution and KMail plugin's names too, but
>    given the nature of the specification this doesn't matter for end
>    users (the registry communicates the path names and the changes get
>    picked up automatically)
>
> Conclusions
>
> o. Yes we are aware that this breaks your application.
> o. Indeed, we know that it breaks your application.
> o. You are right that it breaks your application, and we also know that.
> o. That's right, this breaks your application. You're right.
>
> Why now?
>
> o. Because if we'd do this after an alpha release, there will be even
>    more of you people with broken applications.
>
> Why don't you continue supporting the old API?
>
> o. Because then you guys won't switch to the new one until we disable
>    the old one. So it doesn't matter anyway. You'll just have to do it
>    now, now that we haven't made any promises about what is in master
>    yet.
>
>
> Opinions?
>
> /me puts on his armor
-- 
Philip Van Hoof, freelance software developer
home: me at pvanhoof dot be 
gnome: pvanhoof at gnome dot org 
http://pvanhoof.be/blog
http://codeminded.be