[next] telepathy-glib: spec 0.27.2
Xavier Claessens
xclaesse at kemper.freedesktop.org
Wed Sep 25 12:50:24 PDT 2013
Module: telepathy-glib
Branch: next
Commit: 01c89d0e02cb1233403c42cafc979567e93e8142
URL: http://cgit.freedesktop.org/telepathy/telepathy-glib/commit/?id=01c89d0e02cb1233403c42cafc979567e93e8142
Author: Guillaume Desmottes <guillaume.desmottes at collabora.co.uk>
Date: Tue Sep 24 12:58:27 2013 +0200
spec 0.27.2
---
spec/Account_Interface_Addressing.xml | 8 ++++++++
spec/Channel_Interface_Room_Config.xml | 2 +-
spec/Channel_Interface_Tube.xml | 3 ++-
spec/Channel_Type_Call.xml | 4 ++--
spec/Channel_Type_DBus_Tube.xml | 7 +++++--
spec/Channel_Type_Room_List.xml | 3 ++-
spec/Channel_Type_Stream_Tube.xml | 7 +++++--
spec/Connection.xml | 6 +++---
spec/all.xml | 2 +-
9 files changed, 29 insertions(+), 13 deletions(-)
diff --git a/spec/Account_Interface_Addressing.xml b/spec/Account_Interface_Addressing.xml
index 4b2846b..1692ba7 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 18bb06f..15ef099 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 f31ab21..72f7794 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 6deab1f..eee38a9 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 74e6595..e79ba5a 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 b2b886f..7347a1f 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 63e7b2f..83655c3 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 ed02437..ef862b4 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 31aaff6..e1c8647 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>
More information about the telepathy-commits
mailing list