From edfc2df2f4d6f6f0c310e77b730cc37c1bca59b2 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Mon, 4 Nov 2013 15:48:03 +0000 Subject: [PATCH 07/12] HandleWithTime: fold into HandleWith --- spec/Channel_Dispatch_Operation.xml | 74 ++++--------------------------------- 1 file changed, 8 insertions(+), 66 deletions(-) diff --git a/spec/Channel_Dispatch_Operation.xml b/spec/Channel_Dispatch_Operation.xml index 108c990..6c770f2 100644 --- a/spec/Channel_Dispatch_Operation.xml +++ b/spec/Channel_Dispatch_Operation.xml @@ -195,6 +195,14 @@ + + +

The time at which user action occurred, + or 0 if no user action was involved in selecting the + Handler or approving handling.

+ + + @@ -295,72 +303,6 @@ - - - At the time of writing, no released implementation of the - Channel Dispatcher implements this method; clients should fall - back to calling HandleWith. - - -

A variant of HandleWith allowing the - approver to pass an user action time. This timestamp will be passed - to the Handler when HandleChannel - is called.

- - - - -

The well-known bus name (starting with - im.telepathy.v1.Client.) of the channel - handler that should handle the channel, or the empty string - if the client has no preferred channel handler.

- - - - - -

The time at which user action occurred.

- - - - - - - The selected handler is non-empty, but is not a syntactically - correct DBus_Bus_Name or does not start with - "im.telepathy.v1.Client.". - - - - - The selected handler is temporarily unable to handle this - channel. - - - - - The selected handler is syntactically correct, but will never - be able to handle these channels (for instance because the channel - does not match its HandlerChannelFilter, or because HandleChannel - raised NotImplemented). - - - - - At the time that HandleWith was called, this dispatch operation was - processing an earlier call to HandleWith. The earlier call has - now succeeded, so some Handler nominated by another approver is - now responsible for the channel. In this situation, the second - call to HandleWith MUST NOT return until the first one has - returned successfully or unsuccessfully, and if the first call - to HandleChannel fails, the channel dispatcher SHOULD try to obey - the choice of Handler made by the second call to HandleWith. - - - - -

Emitted when this dispatch operation finishes. The dispatch -- 1.8.4.2