summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2008-10-29 16:43:28 +0000
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2008-10-29 16:43:28 +0000
commit030c1ac86af575b12873832dd3b5e882c6cd6a73 (patch)
tree5b905a18f1fdd651d7ddeabd0123a9b9b958fc96
parent181d30224c4dc30bff5909bbc5caca6f284fb938 (diff)
Text, Messages: add 'rescued' flag
-rw-r--r--spec/Channel_Interface_Messages.xml10
-rw-r--r--spec/Channel_Type_Text.xml15
2 files changed, 25 insertions, 0 deletions
diff --git a/spec/Channel_Interface_Messages.xml b/spec/Channel_Interface_Messages.xml
index b6ae33cc..7fefabbb 100644
--- a/spec/Channel_Interface_Messages.xml
+++ b/spec/Channel_Interface_Messages.xml
@@ -280,6 +280,16 @@ USA.</p>
<tp:type>Channel_Text_Message_Flags</tp:type>). This flag
does not make sense on outgoing messages and SHOULD NOT
appear there.</dd>
+
+ <dt>rescued (b)</dt>
+ <dd>If present and true, the incoming message has been seen in
+ a previous channel during the lifetime of the Connection,
+ but had not been acknowledged when that channel closed, causing
+ an identical channel (in which the message now appears) to open.
+ This matches the Rescued flag in
+ <tp:type>Channel_Text_Message_Flags</tp:type>; it
+ does not make sense on outgoing messages, and SHOULD NOT
+ appear there.</dd>
</dl>
</div>
diff --git a/spec/Channel_Type_Text.xml b/spec/Channel_Type_Text.xml
index 8d5020cd..b0737d03 100644
--- a/spec/Channel_Type_Text.xml
+++ b/spec/Channel_Type_Text.xml
@@ -363,6 +363,21 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:rationale>
</tp:docstring>
</tp:flag>
+
+ <tp:flag suffix="Rescued" value="8">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The incoming message has been seen in a previous channel during
+ the lifetime of the Connection, but had not been acknowledged
+ when that channel closed, causing an identical channel (the
+ channel in which the message now appears) to open.</p>
+
+ <tp:rationale>
+ <p>This means that a logger (which should already have seen the
+ message in the previous channel) is able to recognise and ignore
+ these replayed messages.</p>
+ </tp:rationale>
+ </tp:docstring>
+ </tp:flag>
</tp:flags>
<tp:property name="anonymous" type="b">