[Telepathy-commits] [telepathy-spec/master] Messages: Improve unclear rationale for double signal-emission

[Simon McVittie]

---
 spec/Channel_Interface_Messages.xml |   16 ++++++++--------
 1 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/spec/Channel_Interface_Messages.xml b/spec/Channel_Interface_Messages.xml
index 1c43e4d..c9fdaf8 100644
--- a/spec/Channel_Interface_Messages.xml
+++ b/spec/Channel_Interface_Messages.xml
@@ -569,10 +569,10 @@ USA.</p>
         <tp:rationale>
           <p>This signal allows a process that is not the caller of
             SendMessage to log sent messages. The double signal-emission
-            means that clients can safely follow the following rule:
-            if the channel has the Messages interface, listen for
-            Messages.MessageSent only; otherwise, listen for Text.Sent
-            only.</p>
+            provides compatibility with older clients. Clients supporting
+            Messages should listen for Messages.MessageSent only (if the
+            channel has the Messages interface) or Text.Sent only
+            (otherwise).</p>
         </tp:rationale>
 
         <p>Emission of this signal MAY be delayed until some time after
@@ -706,10 +706,10 @@ USA.</p>
         Received signal on the Text interface.
 
         <tp:rationale>
-          The double signal-emission means that clients can safely follow
-          the following rule: if the channel has the Messages interface,
-          listen for Messages.MessageReceived only; otherwise, listen for
-          Text.Received only.
+          The double signal-emission provides compatibility with older
+          clients. Clients supporting Messages should listen for
+          Messages.MessageSent only (if the channel has the Messages
+          interface) or Text.Sent only (otherwise).
         </tp:rationale>
       </tp:docstring>
 
-- 
1.5.6.5