Prepare version 0.25.2telepathy-spec-0.25.2

21 files changed, 70 insertions, 20 deletions

diff --git a/NEWS b/NEWS
index 5d63cec8..c5b7b944 100644
--- a/NEWS
+++ b/NEWS
@@ -2,6 +2,56 @@ This file contains the same edited highlights as the announcement emails.
 For full details, see the ChangeLog in tarballs, or "git log" in Git
 checkouts.
 
+telepathy-spec 0.25.2 (2012-02-20)
+==================================
+
+New stable API:
+
+• The Call1 family of interfaces (except for the Mute interface) is now
+  considered stable, with significant changes since 0.25.1:
+
+  · Content.Removed signal removed, use Call1.ContentRemoved instead
+  · Content.I.DTMF added; this supersedes everything in Channel.I.DTMF
+    except the InitialTones property
+  · Various redundant contact handles removed from Content.I.Media
+  · MediaDescription.Reject has an "in" argument, not a nonsensical "out"
+    argument
+  · Stream.I.Media no longer has Pending_Pause or Paused states
+  · The Ringing state has been renamed to Initialising to avoid confusion
+    with the Ringing flag
+  · Call1.AddContent takes an initial direction as its new last parameter
+  · Call_Flag_Locally_Muted has been removed and the other Call_Flags
+    have been renumbered
+  · Call_Member_Flag_Ringing has been removed and the other Call_Member_Flags
+    have been renumbered
+  · The destination of a forwarded call is published in the CallStateDetails,
+    rather than abusing the Actor member of CallStateReason
+
+• Connection.I.Addressing1 is now stable, and identical to
+  Connection.I.Addressing.DRAFT in 0.25.1 except for its name
+
+• Account.Supersedes has been added
+
+• Connection.I.ContactList.DownloadAtConnection has been added, together with
+  the Download method
+
+• A serialization has been defined for arrays of object path in .manager
+  files (and by extension, anything sharing that format)
+
+Clarifications:
+
+• Account.Service should also be used for IRC networks
+
+• Channel.I.DTMF.InitialTones should only be used in conjunction with
+  InitialAudio=TRUE
+
+• The policy for versioned interfaces is now documented
+
+Changes to experimental API:
+
+• Channel.I.Addressing1 is the new name for Channel.I.Addressing.DRAFT,
+  but is still considered experimental
+
 telepathy-spec 0.25.1 (2011-11-23)
 ==================================
 
diff --git a/spec/Call_Content.xml b/spec/Call_Content.xml
index f738a289..be3376fe 100644
--- a/spec/Call_Content.xml
+++ b/spec/Call_Content.xml
@@ -21,7 +21,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content">
-    <tp:added version="0.19.0">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>This object represents one Content inside a <tp:dbus-ref
diff --git a/spec/Call_Content_Interface_Audio_Control.xml b/spec/Call_Content_Interface_Audio_Control.xml
index e21dae44..0efb488c 100644
--- a/spec/Call_Content_Interface_Audio_Control.xml
+++ b/spec/Call_Content_Interface_Audio_Control.xml
@@ -20,7 +20,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.Interface.AudioControl">
-    <tp:added version="0.25.1">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.Interface.Media"/>
     <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal" value="true"/>
 
diff --git a/spec/Call_Content_Interface_DTMF.xml b/spec/Call_Content_Interface_DTMF.xml
index b7147afa..f6e9bda0 100644
--- a/spec/Call_Content_Interface_DTMF.xml
+++ b/spec/Call_Content_Interface_DTMF.xml
@@ -19,8 +19,8 @@ License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
   </tp:license>
   <interface name="org.freedesktop.Telepathy.Call1.Content.Interface.DTMF">
-    <tp:added version="0.UNRELEASED">(draft 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content"/>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       An interface that gives audio Contents the ability to send DTMF events
diff --git a/spec/Call_Content_Interface_Media.xml b/spec/Call_Content_Interface_Media.xml
index fe053e2b..3f04df9b 100644
--- a/spec/Call_Content_Interface_Media.xml
+++ b/spec/Call_Content_Interface_Media.xml
@@ -22,7 +22,7 @@
 
   <interface
       name="org.freedesktop.Telepathy.Call1.Content.Interface.Media">
-    <tp:added version="0.23.4">(draft 2)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Call_Content_Interface_Video_Control.xml b/spec/Call_Content_Interface_Video_Control.xml
index 992dc230..5a11dcba 100644
--- a/spec/Call_Content_Interface_Video_Control.xml
+++ b/spec/Call_Content_Interface_Video_Control.xml
@@ -20,7 +20,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.Interface.VideoControl">
-    <tp:added version="0.21.10">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.Interface.Media"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Call_Content_Media_Description.xml b/spec/Call_Content_Media_Description.xml
index 6ed7d08a..88791a25 100644
--- a/spec/Call_Content_Media_Description.xml
+++ b/spec/Call_Content_Media_Description.xml
@@ -21,7 +21,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.MediaDescription">
-    <tp:added version="0.23.4">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       This object represents a remote Description Offer to which the local
diff --git a/spec/Call_Content_Media_Description_Interface_RTCP_Extended_Reports.xml b/spec/Call_Content_Media_Description_Interface_RTCP_Extended_Reports.xml
index ec1352eb..eb5fbdb6 100644
--- a/spec/Call_Content_Media_Description_Interface_RTCP_Extended_Reports.xml
+++ b/spec/Call_Content_Media_Description_Interface_RTCP_Extended_Reports.xml
@@ -19,7 +19,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.MediaDescription.Interface.RTCPExtendedReports">
-    <tp:added version="0.23.4">(draft version, not API-stable)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires
     interface="org.freedesktop.Telepathy.Call1.Content.MediaDescription"/>
 
diff --git a/spec/Call_Content_Media_Description_Interface_RTCP_Feedback.xml b/spec/Call_Content_Media_Description_Interface_RTCP_Feedback.xml
index b3d47361..7a558cc3 100644
--- a/spec/Call_Content_Media_Description_Interface_RTCP_Feedback.xml
+++ b/spec/Call_Content_Media_Description_Interface_RTCP_Feedback.xml
@@ -19,7 +19,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.MediaDescription.Interface.RTCPFeedback">
-    <tp:added version="0.23.4">(draft version, not API-stable)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.MediaDescription"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Call_Content_Media_Description_Interface_RTP_Header_Extensions.xml b/spec/Call_Content_Media_Description_Interface_RTP_Header_Extensions.xml
index 0f0a5b19..25a77e02 100644
--- a/spec/Call_Content_Media_Description_Interface_RTP_Header_Extensions.xml
+++ b/spec/Call_Content_Media_Description_Interface_RTP_Header_Extensions.xml
@@ -19,7 +19,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Content.MediaDescription.Interface.RTPHeaderExtensions">
-    <tp:added version="0.23.4">(draft version, not API-stable)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.MediaDescription"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Call_Interface_Mute.xml b/spec/Call_Interface_Mute.xml
index 1202383f..573efcc8 100644
--- a/spec/Call_Interface_Mute.xml
+++ b/spec/Call_Interface_Mute.xml
@@ -19,7 +19,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Interface.Mute" tp:causes-havoc="experimental">
-    <tp:added version="0.19.6">(draft version, not API-stable)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:xor-requires>
       <tp:requires interface="org.freedesktop.Telepathy.Channel.Type.Call1"/>
       <tp:requires interface="org.freedesktop.Telepathy.Call1.Content"/>
diff --git a/spec/Call_Stream.xml b/spec/Call_Stream.xml
index 5f1321eb..729dc7ea 100644
--- a/spec/Call_Stream.xml
+++ b/spec/Call_Stream.xml
@@ -21,7 +21,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Stream">
-    <tp:added version="0.19.0">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>One stream inside a <tp:dbus-ref
diff --git a/spec/Call_Stream_Endpoint.xml b/spec/Call_Stream_Endpoint.xml
index b03a1547..cf2397b4 100644
--- a/spec/Call_Stream_Endpoint.xml
+++ b/spec/Call_Stream_Endpoint.xml
@@ -21,7 +21,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Stream.Endpoint">
-    <tp:added version="0.19.0">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>This object represents an endpoint for a stream. In a one-to-one
diff --git a/spec/Call_Stream_Interface_Media.xml b/spec/Call_Stream_Interface_Media.xml
index b5ce347c..1356faa1 100644
--- a/spec/Call_Stream_Interface_Media.xml
+++ b/spec/Call_Stream_Interface_Media.xml
@@ -21,7 +21,7 @@
   </tp:license>
 
   <interface name="org.freedesktop.Telepathy.Call1.Stream.Interface.Media">
-    <tp:added version="0.19.0">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Call1.Stream"/>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Channel_Interface_Captcha_Authentication.xml b/spec/Channel_Interface_Captcha_Authentication.xml
index 22f3440f..27b1e0cf 100644
--- a/spec/Channel_Interface_Captcha_Authentication.xml
+++ b/spec/Channel_Interface_Captcha_Authentication.xml
@@ -18,7 +18,7 @@ License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
   </tp:license>
   <interface name="org.freedesktop.Telepathy.Channel.Interface.CaptchaAuthentication1">
-    <tp:added version="0.UNRELEASED">(version 1)</tp:added>
+    <tp:added version="0.25.2">(version 1)</tp:added>
     <tp:requires interface="org.freedesktop.Telepathy.Channel"/>
     <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal"
       value="true"/>
diff --git a/spec/Channel_Interface_DTMF.xml b/spec/Channel_Interface_DTMF.xml
index e328d67c..00e3a549 100644
--- a/spec/Channel_Interface_DTMF.xml
+++ b/spec/Channel_Interface_DTMF.xml
@@ -24,7 +24,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       <tp:requires interface="org.freedesktop.Telepathy.Channel.Type.Call1"/>
     </tp:xor-requires>
 
-    <tp:changed version="0.UNRELEASED">The only part of this spec that should
+    <tp:changed version="0.25.2">The only part of this spec that should
     be used with a Call1 channel is the "InitialTones" property.
     </tp:changed>
 
diff --git a/spec/Channel_Type_Call.xml b/spec/Channel_Type_Call.xml
index 84493e20..383db251 100644
--- a/spec/Channel_Type_Call.xml
+++ b/spec/Channel_Type_Call.xml
@@ -18,7 +18,7 @@ License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   </tp:license>
   <interface name="org.freedesktop.Telepathy.Channel.Type.Call1">
-    <tp:added version="0.19.0">(draft 1)</tp:added>
+    <tp:added version="0.25.2">(as stable API)</tp:added>
 
     <tp:requires interface="org.freedesktop.Telepathy.Channel"/>
     <tp:requires
diff --git a/spec/Connection_Interface_Contact_List.xml b/spec/Connection_Interface_Contact_List.xml
index 66834da9..7b9499ff 100644
--- a/spec/Connection_Interface_Contact_List.xml
+++ b/spec/Connection_Interface_Contact_List.xml
@@ -844,7 +844,7 @@
     <property name="DownloadAtConnection" type="b" access="read"
       tp:name-for-bindings="Download_At_Connection"
       tp:is-connection-parameter='yes'>
-      <tp:added version="0.UNRELEASED"/>
+      <tp:added version="0.25.2"/>
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>If true, the contact list is automatically downloaded at
           connection. If false, the contact list is only downloaded
diff --git a/spec/Connection_Manager.xml b/spec/Connection_Manager.xml
index 20820ad4..9782db59 100644
--- a/spec/Connection_Manager.xml
+++ b/spec/Connection_Manager.xml
@@ -626,7 +626,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       CMs with no .manager file was not explicitly required.</tp:changed>
     <tp:changed version="0.17.16">Prior to version 0.17.16 the serialization
       of string arrays (signature 'as') was not defined</tp:changed>
-    <tp:changed version="0.UNRELEASED">Prior to version 0.UNRELEASED the
+    <tp:changed version="0.25.2">Prior to version 0.25.2 the
       serialization of object-path arrays (signature 'ao') was not
       defined</tp:changed>
   </interface>
diff --git a/spec/all.xml b/spec/all.xml
index 186fbfc1..9e99d705 100644
--- a/spec/all.xml
+++ b/spec/all.xml
@@ -3,7 +3,7 @@
   xmlns:xi="http://www.w3.org/2001/XInclude">
 
 <tp:title>Telepathy D-Bus Interface Specification</tp:title>
-<tp:version>0.25.1.1</tp:version>
+<tp:version>0.25.2</tp:version>
 
 <tp:copyright>Copyright © 2005-2012 Collabora Limited</tp:copyright>
 <tp:copyright>Copyright © 2005-2011 Nokia Corporation</tp:copyright>
diff --git a/spec/errors.xml b/spec/errors.xml
index c9e85dd3..d802152a 100644
--- a/spec/errors.xml
+++ b/spec/errors.xml
@@ -638,7 +638,7 @@
   </tp:error>
 
   <tp:error name="Captcha Not Supported">
-    <tp:added version="0.UNRELEASED"/>
+    <tp:added version="0.25.2"/>
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>Raised if the <tp:dbus-ref 
         namespace="ofdT.Channel.Interface">CaptchaAuthentication1</tp:dbus-ref>