[telepathy-spec/master] NEWS and versioning annotations

Simon McVittie simon.mcvittie at collabora.co.uk
Tue Dec 1 10:10:07 PST 2009


---
 NEWS                                            |   48 ++++++++++++++++++++++-
 spec/Call_Content.xml                           |    2 +-
 spec/Call_Content_Codec_Offer.xml               |    2 +-
 spec/Call_Content_Interface_Media.xml           |    2 +-
 spec/Call_Stream.xml                            |    2 +-
 spec/Call_Stream_Endpoint.xml                   |    2 +-
 spec/Call_Stream_Interface_Media.xml            |    2 +-
 spec/Channel_Dispatcher.xml                     |    2 +-
 spec/Channel_Interface_Conference.xml           |    1 +
 spec/Channel_Interface_Mergeable_Conference.xml |    1 +
 spec/Channel_Interface_Splittable.xml           |    1 +
 spec/Channel_Type_Call.xml                      |    2 +-
 spec/Connection_Future.xml                      |    2 +-
 spec/Connection_Interface_Balance.xml           |    2 +-
 14 files changed, 60 insertions(+), 11 deletions(-)

diff --git a/NEWS b/NEWS
index 5f80e44..9f4b22f 100644
--- a/NEWS
+++ b/NEWS
@@ -5,16 +5,62 @@ checkouts.
 telepathy-spec 0.19.0 (UNRELEASED)
 ==================================
 
-Enhancements:
+New stable API:
+
+* fd.o #24903: Connection.Interface.Balance, an API for machine-readable
+  account balance (e.g. SkypeOut credit) (mikhailz, Naveen)
 
 * fd.o #24938: added 'skype' (Skype) and 'tel' (telephony) to the list of
   well-known protocol names (smcv)
 
+New experimental API:
+
+* fd.o #24906, fd.o #24939: Conference (draft 1), an interface for multi-user
+  text or media conferences that can be made by merging or upgrading 1-1
+  channels (smcv)
+
+* fd.o #24906: MergeableConference (draft 1), an extra interface for Conference
+  channels that can have additional 1-1 channels merged into them
+
+* fd.o #24906: Splittable (draft 1), an interface for 1-1 channels that can be
+  removed from a Conference
+
+* fd.o #24936: Call (draft 1), a channel type for calls (and a collection of
+  subsidiary objects in the org.freedesktop.Telepathy.Call namespace),
+  which will eventually replace StreamedMedia (and MediaSignalling where
+  applicable) (sjoerd, smcv)
+
+* fd.o #24661: EnsureSidecar, a method to request extra one-per-connection
+  objects (conceptually the same as Connection interfaces, but implementable
+  as plugins) (wjt)
+
+Experimental API removed:
+
+* Channel.Interface.CallMerging has been superseded by Conference and removed
+
 Clarifications:
 
+* fd.o #24004: specified that PreferredHandler applies even if that handler's
+  filter doesn't match the channel, which has been implemented since
+  telepathy-mission-control 5.3.2 (wjt)
+
 * fd.o #24851: declared that ChatState makes no sense without Text, validating
   the decision to put ChatState API on Tp::TextChannel in telepathy-qt4 (smcv)
 
+* fd.o #25316: specified that TargetHandleType should be a fixed property
+  in all ContactCapabilities, and defined a meaning for non-CONTACT entries
+  in ContactCapabilities (smcv)
+
+* fixed some confusing typos (sjoerd, smcv)
+
+Tools changes:
+
+* The old single-page HTML spec has been replaced by a simple redirect to the
+  multi-page version
+
+* The spec parser correctly verifies that every method, signal and property
+  has tp:name-for-bindings, which is necessary for good code generation
+
 telepathy-spec 0.18.0 (2009-09-24)
 ==================================
 
diff --git a/spec/Call_Content.xml b/spec/Call_Content.xml
index b903e56..1d5e891 100644
--- a/spec/Call_Content.xml
+++ b/spec/Call_Content.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Content.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       This object represents one Content inside a Call. For example in an
diff --git a/spec/Call_Content_Codec_Offer.xml b/spec/Call_Content_Codec_Offer.xml
index 55f8d17..31ff0b3 100644
--- a/spec/Call_Content_Codec_Offer.xml
+++ b/spec/Call_Content_Codec_Offer.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Content.CodecOffer.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       This object represents an offer of a Codec payload mapping.
diff --git a/spec/Call_Content_Interface_Media.xml b/spec/Call_Content_Interface_Media.xml
index 78c9479..2b3eb65 100644
--- a/spec/Call_Content_Interface_Media.xml
+++ b/spec/Call_Content_Interface_Media.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Content.Interface.Media.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call.Content"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Call_Stream.xml b/spec/Call_Stream.xml
index cd6649e..302bd5e 100644
--- a/spec/Call_Stream.xml
+++ b/spec/Call_Stream.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Stream.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       One stream inside a content
diff --git a/spec/Call_Stream_Endpoint.xml b/spec/Call_Stream_Endpoint.xml
index 7277d25..fbab2cf 100644
--- a/spec/Call_Stream_Endpoint.xml
+++ b/spec/Call_Stream_Endpoint.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Stream.Endpoint.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       This object represents a set of candidates of one end-point.
diff --git a/spec/Call_Stream_Interface_Media.xml b/spec/Call_Stream_Interface_Media.xml
index 6fb7adf..ccf9033 100644
--- a/spec/Call_Stream_Interface_Media.xml
+++ b/spec/Call_Stream_Interface_Media.xml
@@ -22,7 +22,7 @@
 
   <interface name="org.freedesktop.Telepathy.Call.Stream.Interface.Media.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call.Stream"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Channel_Dispatcher.xml b/spec/Channel_Dispatcher.xml
index 07af995..daee24c 100644
--- a/spec/Channel_Dispatcher.xml
+++ b/spec/Channel_Dispatcher.xml
@@ -228,7 +228,7 @@
             property.</p>
         </tp:docstring>
 
-        <tp:changed version="0.19.UNRELEASED">
+        <tp:changed version="0.19.0">
           Previously, the spec didn't say that this should disregard the
           handler's filter. This has been implemented since
           telepathy-mission-control 5.3.2.
diff --git a/spec/Channel_Interface_Conference.xml b/spec/Channel_Interface_Conference.xml
index 2a44aca..af3e627 100644
--- a/spec/Channel_Interface_Conference.xml
+++ b/spec/Channel_Interface_Conference.xml
@@ -22,6 +22,7 @@
   <interface
     name="org.freedesktop.Telepathy.Channel.Interface.Conference.DRAFT"
     tp:causes-havoc="experimental">
+    <tp:added version="0.19.0">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Channel"/>
     <tp:requires
       interface="org.freedesktop.Telepathy.Channel.Interface.Group"/>
diff --git a/spec/Channel_Interface_Mergeable_Conference.xml b/spec/Channel_Interface_Mergeable_Conference.xml
index 95d815b..989ffac 100644
--- a/spec/Channel_Interface_Mergeable_Conference.xml
+++ b/spec/Channel_Interface_Mergeable_Conference.xml
@@ -22,6 +22,7 @@
   <interface
     name="org.freedesktop.Telepathy.Channel.Interface.MergeableConference.DRAFT"
     tp:causes-havoc="experimental">
+    <tp:added version="0.19.0">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Channel.Interface.Conference.DRAFT"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Channel_Interface_Splittable.xml b/spec/Channel_Interface_Splittable.xml
index 73291fa..063565e 100644
--- a/spec/Channel_Interface_Splittable.xml
+++ b/spec/Channel_Interface_Splittable.xml
@@ -22,6 +22,7 @@
   <interface
     name="org.freedesktop.Telepathy.Channel.Interface.Splittable.DRAFT"
     tp:causes-havoc="experimental">
+    <tp:added version="0.19.0">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Channel"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Channel_Type_Call.xml b/spec/Channel_Type_Call.xml
index 07a8327..702eb17 100644
--- a/spec/Channel_Type_Call.xml
+++ b/spec/Channel_Type_Call.xml
@@ -19,7 +19,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
   <interface name="org.freedesktop.Telepathy.Channel.Type.Call.DRAFT"
       tp:causes-havoc="experimental">
-    <tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
+    <tp:added version="0.19.0">(draft 1)</tp:added>
 
     <tp:requires interface="org.freedesktop.Telepathy.Channel"/>
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Connection_Future.xml b/spec/Connection_Future.xml
index 1104798..6b5291e 100644
--- a/spec/Connection_Future.xml
+++ b/spec/Connection_Future.xml
@@ -25,7 +25,7 @@ USA.</p>
     <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
 
     <method name="EnsureSidecar" tp:name-for-bindings="Ensure_Sidecar">
-      <tp:added version="0.19.UNRELEASED"/>
+      <tp:added version="0.19.0">(as a draft)</tp:added>
 
       <arg direction="in" name="Main_Interface" type="s"
            tp:type="DBus_Interface">
diff --git a/spec/Connection_Interface_Balance.xml b/spec/Connection_Interface_Balance.xml
index 4c0fbd0..1042bec 100644
--- a/spec/Connection_Interface_Balance.xml
+++ b/spec/Connection_Interface_Balance.xml
@@ -21,7 +21,7 @@
   </tp:license>
   <interface name="org.freedesktop.Telepathy.Connection.Interface.Balance">
     <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
-    <tp:added version="0.19.UNRELEASED">(as stable API)</tp:added>
+    <tp:added version="0.19.0">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>In many real-time communication services the user can pay for certain
-- 
1.5.6.5




More information about the telepathy-commits mailing list