Bug 46152

Summary: [1.0] document policy for interfaces: "core" vs. versioned
Product: Telepathy Reporter: Simon McVittie <smcv>
Component: tp-specAssignee: Simon McVittie <smcv>
Status: RESOLVED MOVED QA Contact: Telepathy bugs list <telepathy-bugs>
Severity: normal    
Priority: medium CC: jonny.lamb
Version: git master   
Hardware: Other   
OS: All   
URL: http://cgit.freedesktop.org/~smcv/telepathy-spec/log/?h=next-version-the-world
Whiteboard:
i915 platform: i915 features:
Attachments: Version the names and node-names of all versioned interfaces
Put Call1 in the node name, filename of Call1 sub-objects
Document Telepathy 1.0 versioning conventions

Description Simon McVittie 2012-02-16 02:30:16 UTC
As discussed on Bug #26866, to be able to generate code for Foo1 and Foo2 simultaneously, we need to include the version number in their filenames and node names.
Comment 1 Simon McVittie 2012-02-16 02:31:29 UTC
Created attachment 57135 [details] [review]
Version the names and node-names of all versioned  interfaces

Otherwise, either we can't generate code for Foo1 and Foo2 simultaneously,
or the rules for when you version and when you don't are really
confusing. See fd.o #26866.
Comment 2 Simon McVittie 2012-02-16 02:31:48 UTC
Created attachment 57136 [details] [review]
Put Call1 in the node name, filename of Call1  sub-objects
Comment 3 Simon McVittie 2012-02-16 02:32:03 UTC
Created attachment 57137 [details] [review]
Document Telepathy 1.0 versioning conventions
Comment 4 Simon McVittie 2012-02-16 02:35:07 UTC
I believe this is a necessary consequence of what Jonny proposed on Bug #26866, and worth doing to have less confusing rules for versioning than we do on master.
Comment 5 Jonny Lamb 2012-02-16 13:19:00 UTC
This all looks good.

We should point out more why some other interfaces are core (Text because if you break that Telepathy can be useless; Call1.Content.Interface.Media because that'll just break Calls; etc.) but we can do that at some point. No rush.
Comment 6 Simon McVittie 2012-02-17 07:22:18 UTC
(In reply to comment #5)
> We should point out more why some other interfaces are core (Text because
> if you break that Telepathy can be useless; Call1.Content.Interface.Media
> because that'll just break Calls; etc.) but we can do that at some point.

Right, I'd missed that Text was still core. I reverted addition of its version number and uploaded a snapshot to:

http://telepathy.freedesktop.org/spec-next/

Leaving this bug open for "point out which interfaces are/should be core".
Comment 7 GitLab Migration User 2019-12-03 20:25:40 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/telepathy/telepathy-spec/issues/128.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.