Bug 46152 - [1.0] document policy for interfaces: "core" vs. versioned
Summary: [1.0] document policy for interfaces: "core" vs. versioned
Status: RESOLVED MOVED
Alias: None
Product: Telepathy
Classification: Unclassified
Component: tp-spec (show other bugs)
Version: git master
Hardware: Other All
: medium normal
Assignee: Simon McVittie
QA Contact: Telepathy bugs list
URL: http://cgit.freedesktop.org/~smcv/tel...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-02-16 02:30 UTC by Simon McVittie
Modified: 2019-12-03 20:25 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments
Version the names and node-names of all versioned interfaces (74.14 KB, patch)
2012-02-16 02:31 UTC, Simon McVittie
Details | Splinter Review
Put Call1 in the node name, filename of Call1 sub-objects (13.25 KB, patch)
2012-02-16 02:31 UTC, Simon McVittie
Details | Splinter Review
Document Telepathy 1.0 versioning conventions (3.20 KB, patch)
2012-02-16 02:32 UTC, Simon McVittie
Details | Splinter Review

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.