summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--spec/Channel_Interface_Subject.xml13
1 files changed, 12 insertions, 1 deletions
diff --git a/spec/Channel_Interface_Subject.xml b/spec/Channel_Interface_Subject.xml
index 36d43c04..d60e25b5 100644
--- a/spec/Channel_Interface_Subject.xml
+++ b/spec/Channel_Interface_Subject.xml
@@ -109,7 +109,18 @@
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>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>, otherwise FALSE.</p>
+ <tp:member-ref>SetSubject</tp:member-ref>, otherwise
+ FALSE.</p>
+
+ <p>If implementations are unsure of what this value should be
+ it SHOULD still be set to what it believes the value
+ is. As a result, clients should be aware that
+ <tp:member-ref>SetSubject</tp:member-ref> can still fail
+ even with this property set to TRUE.</p>
+
+ <tp:rationale>In XMPP it is impossible to know whether an
+ occupant can set the subject as XMPP server implementations
+ are wildly inconsistent.</tp:rationale>
<p>Change notification for this property is provided by the
standard D-Bus <code>PropertiesChanged</code> signal.</p>