summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonny Lamb <jonny.lamb@collabora.co.uk>2011-05-09 15:50:38 +0100
committerWill Thompson <will.thompson@collabora.co.uk>2011-08-25 19:10:21 +0100
commit5853c87b69c516014905a5a711db8d5ad07a5bcd (patch)
tree78edcabfb232bd56a066ad7f4d4c4c35789af6d1
parentc06589821e3b5ff86564396f733473cafbd813c0 (diff)
Subject: make SetSubject return success if the operation was a success
Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
-rw-r--r--spec/Channel_Interface_Subject.xml39
1 files changed, 4 insertions, 35 deletions
diff --git a/spec/Channel_Interface_Subject.xml b/spec/Channel_Interface_Subject.xml
index 5f5bfcf6..40646d5f 100644
--- a/spec/Channel_Interface_Subject.xml
+++ b/spec/Channel_Interface_Subject.xml
@@ -43,10 +43,10 @@
flags before calling this method as the user might not have
permission to set the subject.</p>
- <p>Clients SHOULD NOT assume success if no errors are raised
- by calling this method, but instead should listen to the
- <tp:member-ref>SubjectChanged</tp:member-ref> signal for
- change notification.</p>
+ <p>A successful return of this method indicates a successful
+ change in subject, but clients should still listen for changes
+ to the <tp:member-ref>Subject</tp:member-ref> property for
+ further changes by other users or the server.</p>
</tp:docstring>
<tp:possible-errors>
<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented"/>
@@ -115,37 +115,6 @@
</tp:docstring>
</property>
- <signal name="SubjectChanged" tp:name-for-bindings="Subject_Changed">
- <arg name="Subject" type="s">
- <tp:docstring>
- The new subject string.
- </tp:docstring>
- </arg>
- <arg name="Actor" type="s">
- <tp:docstring>
- A normalized contact ID representing who last modified the
- subject, or the empty string if it is not known.
- </tp:docstring>
- </arg>
- <arg name="Timestamp" type="x" tp:type="Unix_Timestamp64">
- <tp:docstring>
- A unix timestamp indicating when the subject was last
- modified.
- </tp:docstring>
- </arg>
- <arg name="CanSet" type="b">
- <tp:docstring>
- True if the <tp:member-ref>Subject</tp:member-ref> property
- can be set by the user by calling
- <tp:member-ref>SetSubject</tp:member-ref>.
- </tp:docstring>
- </arg>
- <tp:docstring>
- Emitted when the <tp:member-ref>Subject</tp:member-ref>
- property is changed, otherwise FALSE.
- </tp:docstring>
- </signal>
-
</interface>
</node>
<!-- vim:set sw=2 sts=2 et ft=xml: -->