diff options
Diffstat (limited to 'spec/Client_Handler_Future.xml')
-rw-r--r-- | spec/Client_Handler_Future.xml | 27 |
1 files changed, 25 insertions, 2 deletions
diff --git a/spec/Client_Handler_Future.xml b/spec/Client_Handler_Future.xml index 776fa4f..4c1a8b7 100644 --- a/spec/Client_Handler_Future.xml +++ b/spec/Client_Handler_Future.xml @@ -33,15 +33,38 @@ API or ABI guarantees.</p> </tp:docstring> + <property name="BypassObservers" tp:name-for-bindings="Bypass_Observers" + type="b" access="read"> + <tp:added version="0.21.2"/> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>If true, channels destined for this handler are not passed to + observers for observing.</p> + + <tp:rationale> + <p>This is useful in use-cases where the handler doesn't want anyone + observing the channel - for example, because channels it handles + shouldn't be logged.</p> + </tp:rationale> + + <p>For service-activatable handlers, this property should be specified + in the handler's <tt>.client</tt> file as follows:</p> + +<pre> +[org.freedesktop.Telepathy.Client.Handler] +BypassObservers=true +</pre> + </tp:docstring> + </property> + <property name="RelatedConferencesBypassApproval" tp:name-for-bindings="Related_Conferences_Bypass_Approval" type="b" access="read"> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>If true, channels destined for this handler that have the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface" - >Conference.DRAFT</tp:dbus-ref> interface, with a channel that + >Conference</tp:dbus-ref> interface, with a channel that was previously handled by the same client process in their - <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Conference.DRAFT" + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Conference" >InitialChannels</tp:dbus-ref> property, should bypass the approval stage. In effect, this is a weaker form of <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler" |