diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-09-23 22:03:34 +0100 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-09-23 22:03:34 +0100 |
| commit | 338f2ad6d8c82691d28b75f8d3169714e58d3916 (patch) | |
| tree | d9a00981507150b1168eda2416511ec04e70d7d3 /spec/Channel_Dispatch_Operation.xml | |
| parent | f5b78c0f2ba124170a34e749b4ccaf8747e7ddf6 (diff) | |
CDO: add ChannelLost signal
Diffstat (limited to 'spec/Channel_Dispatch_Operation.xml')
| -rw-r--r-- | spec/Channel_Dispatch_Operation.xml | 37 |
1 files changed, 36 insertions, 1 deletions
diff --git a/spec/Channel_Dispatch_Operation.xml b/spec/Channel_Dispatch_Operation.xml index eadcd527..aec6015d 100644 --- a/spec/Channel_Dispatch_Operation.xml +++ b/spec/Channel_Dispatch_Operation.xml @@ -132,10 +132,45 @@ <tp:docstring> The <tp:dbus-ref namespace="org.freedesktop.Telepathy">Channel</tp:dbus-ref>s - to be dispatched, and their properties. + to be dispatched, and their properties. Change notification is via + the <tp:member-ref>ChannelLost</tp:member-ref> signal (channels + cannot be added to this property, only removed). </tp:docstring> </property> + <signal name="ChannelLost" tp:name-for-bindings="Channel_Lost"> + <tp:docstring> + A channel has closed before it could be claimed or handled. + </tp:docstring> + + <arg name="Error" type="s" tp:type="DBus_Error_Name"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>The name of a D-Bus error indicating why the channel closed. If + no better reason can be found, + <code>org.freedesktop.Telepathy.Errors.NotAvailable</code> MAY + be used as a fallback; this means that this error SHOULD NOT be + given any more specific meaning.</p> + + <p>FIXME: or should we invent a new OtherError for that purpose?</p> + + <p>FIXME: we need to specify errors for these situations:</p> + + <ul> + <li>kicked from a chatroom</li> + <li>outgoing call rejected</li> + <li>outgoing call timed out</li> + <li>incoming call terminated</li> + </ul> + </tp:docstring> + </arg> + + <arg name="Message" type="s"> + <tp:docstring> + A string associated with the D-Bus error. + </tp:docstring> + </arg> + </signal> + <property name="PossibleHandlers" tp:name-for-bindings="Possible_Handlers" type="as" access="read" tp:type="DBus_Well_Known_Name[]"> <tp:docstring> |