spec 0.27.2

9 files changed, 29 insertions, 13 deletions

diff --git a/spec/Account_Interface_Addressing.xml b/spec/Account_Interface_Addressing.xml
index 4b2846b68..1692ba785 100644
--- a/spec/Account_Interface_Addressing.xml
+++ b/spec/Account_Interface_Addressing.xml
@@ -19,6 +19,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
   <interface name="org.freedesktop.Telepathy.Account.Interface.Addressing">
     <tp:requires interface="org.freedesktop.Telepathy.Account"/>
     <tp:added version="0.21.5">(as stable API)</tp:added>
+    <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal"
+                value="true"/>
+    <tp:changed version="0.27.1">
+      The standard D-Bus <code>PropertiesChanged</code> signal is now used
+      for <tp:member-ref>URISchemes</tp:member-ref> property change notifications.
+    </tp:changed>
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>Some accounts can be used for multiple protocols; for instance, SIP
         and Skype accounts can often be used to contact the PSTN, MSN and
@@ -46,6 +52,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
           entirely possible that an account which can be used for a
           given URI scheme is not wanted for it by the user, and
           therefore not flagged as such in this field.</p>
+        <p>Change notification for this property is provided by the
+          standard D-Bus <code>PropertiesChanged</code> signal.</p>
       </tp:docstring>
     </property>
 
diff --git a/spec/Channel_Interface_Room_Config.xml b/spec/Channel_Interface_Room_Config.xml
index 18bb06f0c..15ef0999f 100644
--- a/spec/Channel_Interface_Room_Config.xml
+++ b/spec/Channel_Interface_Room_Config.xml
@@ -30,7 +30,7 @@
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>Represents the configuration of a chatroom, some aspects of which may
-        be modifiable by the user, depending on their priviledges. This
+        be modifiable by the user, depending on their privileges. This
         corresponds to the room configuration on XMPP, and various channel mode
         flags on IRC.</p>
 
diff --git a/spec/Channel_Interface_Tube.xml b/spec/Channel_Interface_Tube.xml
index f31ab2138..72f77945e 100644
--- a/spec/Channel_Interface_Tube.xml
+++ b/spec/Channel_Interface_Tube.xml
@@ -60,7 +60,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     </tp:docstring>
 
     <property name="Parameters" type="a{sv}" tp:type="String_Variant_Map"
-              access="read" tp:name-for-bindings="Parameters">
+              access="read" tp:name-for-bindings="Parameters"
+              tp:immutable="sometimes">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Each tube has a dictionary of arbitrary parameters. Parameters are
           commonly used to bootstrap legacy protocols where you can't
diff --git a/spec/Channel_Type_Call.xml b/spec/Channel_Type_Call.xml
index 6deab1fd9..eee38a954 100644
--- a/spec/Channel_Type_Call.xml
+++ b/spec/Channel_Type_Call.xml
@@ -613,7 +613,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
             the remote client indicates that the user has been notified about
             the call. If the network is known not to provide feedback about whether
             the remote side is ringing, then the call should immediately be
-            set to Ringing.</li>
+            set to Initialised.</li>
           <li>Initialising → Initialised (for incoming calls, when e.g. the
             implementation has been initialised far enough that it is sensible
             to notify the user about the call (to reduce the probability that
@@ -1151,7 +1151,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
         <tp:rationale>
           <p>A connection manager might be intended for a specialized hardware
             device, which will take care of the audio streaming (e.g.
-            telepathy-yafono, which uses GSM hardware which does the actual
+            telepathy-ring, which uses GSM hardware which does the actual
             audio streaming for the call).</p>
         </tp:rationale>
 
diff --git a/spec/Channel_Type_DBus_Tube.xml b/spec/Channel_Type_DBus_Tube.xml
index 74e659514..e79ba5aae 100644
--- a/spec/Channel_Type_DBus_Tube.xml
+++ b/spec/Channel_Type_DBus_Tube.xml
@@ -127,7 +127,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     </signal>
 
     <property name="ServiceName" type="s" access="read"
-              tp:name-for-bindings="Service_Name">
+              tp:name-for-bindings="Service_Name"
+              tp:requestable="yep"
+              tp:immutable="yep">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>A string representing the service name that will be used over the
           tube. It SHOULD be a well-known D-Bus service name, of the form
@@ -170,7 +172,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
     <property name="SupportedAccessControls" type="au"
               tp:type="Socket_Access_Control[]" access="read"
-              tp:name-for-bindings="Supported_Access_Controls">
+              tp:name-for-bindings="Supported_Access_Controls"
+              tp:immutable="yep">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>A list of the access control types that are supported with this channel.
         Note that only Socket_Access_Control_Localhost and
diff --git a/spec/Channel_Type_Room_List.xml b/spec/Channel_Type_Room_List.xml
index b2b886f14..7347a1fc0 100644
--- a/spec/Channel_Type_Room_List.xml
+++ b/spec/Channel_Type_Room_List.xml
@@ -75,7 +75,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
         <dl>
           <dt>handle-name (s)</dt>
           <dd>The identifier of the room (as would be returned by
-            <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>)</dd>
+            <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref>).
+            This property is mandatory.</dd>
 
           <dt>name (s)</dt>
           <dd>The human-readable name of the room if different from the handle</dd>
diff --git a/spec/Channel_Type_Stream_Tube.xml b/spec/Channel_Type_Stream_Tube.xml
index 63e7b2f50..83655c398 100644
--- a/spec/Channel_Type_Stream_Tube.xml
+++ b/spec/Channel_Type_Stream_Tube.xml
@@ -227,7 +227,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     </signal>
 
     <property name="Service" type="s" access="read"
-              tp:name-for-bindings="Service">
+              tp:name-for-bindings="Service"
+              tp:immutable="yes"
+              tp:requestable="yes">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p> A string representing the service name that will be used over the
           tube.  It should be a well-known TCP service name as defined by
@@ -246,7 +248,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
     <property name="SupportedSocketTypes" type="a{uau}"
               tp:type="Supported_Socket_Map" access="read"
-              tp:name-for-bindings="Supported_Socket_Types">
+              tp:name-for-bindings="Supported_Socket_Types"
+              tp:immutable="yes">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>A mapping from address types (members of Socket_Address_Type) to
         arrays of access-control type (members of Socket_Access_Control)
diff --git a/spec/Connection.xml b/spec/Connection.xml
index ed0243786..ef862b4bf 100644
--- a/spec/Connection.xml
+++ b/spec/Connection.xml
@@ -145,7 +145,7 @@ USA.</p>
       <tp:added version="0.17.10">Clients MAY assume that if the
         SelfHandle property exists, this signal will be emitted when
         necessary.</tp:added>
-      <tp:deprecated version="0.UNRELEASED">Use SelfContactChanged to get the
+      <tp:deprecated version="0.27.2">Use SelfContactChanged to get the
       new SelfID at the same time</tp:deprecated>
 
       <arg type="u" tp:type="Contact_Handle" name="Self_Handle">
@@ -164,7 +164,7 @@ USA.</p>
         is not yet in the CONNECTED state, this signal is not guaranteed
         to be emitted.
       </tp:docstring>
-      <tp:added version="0.UNRELEASED">Clients MAY assume that if the
+      <tp:added version="0.27.2">Clients MAY assume that if the
         SelfHandle and SelfID property exists, this signal will be emitted when
         necessary.</tp:added>
 
@@ -206,7 +206,7 @@ USA.</p>
         If the connection is not yet in the CONNECTED state, the value of
         this property MAY be empty string.
       </tp:docstring>
-      <tp:added version="0.UNRELEASED"/>
+      <tp:added version="0.27.2"/>
     </property>
 
     <method name="GetSelfHandle" tp:name-for-bindings="Get_Self_Handle">
diff --git a/spec/all.xml b/spec/all.xml
index 31aaff6fb..e1c8647eb 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.27.0</tp:version>
+<tp:version>0.27.2</tp:version>
 
 <tp:copyright>Copyright © 2005-2012 Collabora Limited</tp:copyright>
 <tp:copyright>Copyright © 2005-2011 Nokia Corporation</tp:copyright>