summaryrefslogtreecommitdiff
path: root/spec/Account.xml
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2010-09-29 15:40:28 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2010-09-29 15:40:28 +0100
commita795bb28d03c0d60785a554794351402a08d875a (patch)
tree865a36a2611f91e8495d3511b1f5feef044499cd /spec/Account.xml
parent9e248b927ffa732f6d8806b84209c3027a760e48 (diff)
downloadtelepathy-glib-a795bb28d03c0d60785a554794351402a08d875a.tar.gz
Update to spec 0.21.1
- add Access_Control, Access_Control_Type - ClientTypes to follow in a later commit
Diffstat (limited to 'spec/Account.xml')
-rw-r--r--spec/Account.xml31
1 files changed, 23 insertions, 8 deletions
diff --git a/spec/Account.xml b/spec/Account.xml
index 5917c6f0b..acd8c3028 100644
--- a/spec/Account.xml
+++ b/spec/Account.xml
@@ -407,16 +407,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
<p>The presence status that this account should have if it is brought
online.</p>
+ <tp:rationale>
+ In ITOS2007 and ITOS2008 this is a global preference, not visible
+ on D-Bus (the "default presence"). "Automatic presence" better
+ describes when it is used.
+ </tp:rationale>
+
<p>Setting this property MUST NOT actually change the account's
status until the next time it is (re)connected for some reason.</p>
- <p>The <tp:type>Connection_Presence_Type</tp:type> in the structure
- SHOULD NOT be Offline or Unset.</p>
+ <p>The value of this property MUST be one that would be acceptable
+ for <tp:member-ref>RequestedPresence</tp:member-ref>,
+ with the additional restriction that the
+ <tp:type>Connection_Presence_Type</tp:type> MUST NOT be Offline.</p>
<tp:rationale>
- In ITOS2007 and ITOS2008 this is a global preference, not visible
- on D-Bus (the "default presence"). "Automatic presence" better
- describes when it is used.
+ <p>Otherwise, it would not be possible to use this presence to bring
+ the account online for a channel request.</p>
</tp:rationale>
</tp:docstring>
</property>
@@ -553,11 +560,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
<property name="CurrentPresence" type="(uss)" access="read"
tp:type="Simple_Presence" tp:name-for-bindings="Current_Presence">
<tp:docstring>
- The actual presence. If the connection is not online, this should be
- (Connection_Presence_Type_Offline, "", "").
+ The actual presence. If the connection is not online, the
+ <tp:type>Connection_Presence_Type</tp:type> SHOULD be
+ Connection_Presence_Type_Offline.
If the connection is online but does not support the <tp:dbus-ref
namespace="org.freedesktop.Telepathy.Connection.Interface">SimplePresence</tp:dbus-ref>
- interface, this should be (Connection_Presence_Type_Unset, "", "").
+ interface, the type SHOULD be Connection_Presence_Type_Unset.
The account manager is expected to set this by observing signals
from the Connection.
@@ -585,6 +593,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
This corresponds to e.g. GetPresence and GetPresenceMessage
in NMC 4.x.
</tp:rationale>
+
+ <p>The <tp:type>Connection_Presence_Type</tp:type> in this property
+ MUST NOT be Unset, Unknown or Error.</p>
+
+ <tp:rationale>
+ <p>Requesting those presence types doesn't make sense.</p>
+ </tp:rationale>
</tp:docstring>
</property>