Attachment 87475 Details for Bug 70382 – [spec master] Add Conn.I.Decloak1, from Gabble

[patch] [spec master] Add Conn.I.Decloak1, from Gabble

0007-Add-Conn.I.Decloak1-from-Gabble.patch (text/plain), 6.11 KB, created by Simon McVittie on 2013-10-11 16:36:22 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2013-10-11 16:36:22 UTC

Size: 6.11 KB

patch

obsolete

>From 7ba697ce669a650f268c5d7975315b3261f97248 Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Fri, 11 Oct 2013 13:22:26 +0100
>Subject: [PATCH 7/7] Add Conn.I.Decloak1, from Gabble
>
>---
> spec/Connection_Interface_Decloak1.xml | 114 +++++++++++++++++++++++++++++++++
> spec/all.xml | 1 +
> 2 files changed, 115 insertions(+)
> create mode 100644 spec/Connection_Interface_Decloak1.xml
>
>diff --git a/spec/Connection_Interface_Decloak1.xml b/spec/Connection_Interface_Decloak1.xml
>new file mode 100644
>index 0000000..8e941ec
>--- /dev/null
>+++ b/spec/Connection_Interface_Decloak1.xml
>@@ -0,0 +1,114 @@
>+<?xml version="1.0" ?>
>+<node name="/Connection_Interface_Decloak1"
>+ xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
>+ <tp:copyright>Copyright Â© 2010 Collabora Ltd.</tp:copyright>
>+ <tp:license xmlns="http://www.w3.org/1999/xhtml">
>+ This library is free software; you can redistribute it and/or
>+ modify it under the terms of the GNU Lesser General Public
>+ License as published by the Free Software Foundation; either
>+ version 2.1 of the License, or (at your option) any later version.
>+
>+ This library is distributed in the hope that it will be useful,
>+ but WITHOUT ANY WARRANTY; without even the implied warranty of
>+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
>+ Lesser General Public License for more details.
>+
>+ You should have received a copy of the GNU Lesser General Public
>+ License along with this library; if not, write to the Free Software
>+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
>+ USA.
>+ </tp:license>
>+
>+ <interface name="org.freedesktop.Telepathy.Connection.Interface.Decloak1">
>+ <tp:added version="0.UNRELEASED"/>
>+ <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
>+
>+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
>+ A simple D-Bus API for <a
>+ href="http://xmpp.org/extensions/xep-0276.html">XEP-0276 Temporary
>+ Presence Sharing</a> or any compatible scheme. See the XEP for
>+ more details.
>+ </tp:docstring>
>+
>+ <property name="DecloakAutomatically"
>+ tp:name-for-bindings="Decloak_Automatically"
>+ type="b" access="readwrite">
>+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
>+ If true, the connection manager will automatically disclose the
>+ local user's capabilities (and hence the fact that they are online,
>+ but no further presence information) on request from any remote XMPP
>+ user.
>+
>+ <tp:rationale>
>+ This is necessary to allow incoming calls from arbitrary
>+ users.
>+ </tp:rationale>
>+
>+ This property SHOULD also be available as a connection manager
>+ parameter, with the DBus_Property flag. The default SHOULD be false
>+ since this constitutes a deliberate presence leak.
>+ </tp:docstring>
>+ </property>
>+
>+ <signal name="DecloakRequested" tp:name-for-bindings="Decloak_Requested">
>+ <tp:docstring>
>+ Emitted when a remote contact asks for the local user's capabilities
>+ and basic presence to be disclosed.
>+ </tp:docstring>
>+
>+ <arg name="Contact" type="u" tp:type="Contact_Handle">
>+ <tp:docstring>
>+ The contact asking for presence disclosure
>+ </tp:docstring>
>+ </arg>
>+
>+ <arg name="Reason" type="s">
>+ <tp:docstring>
>+ A code indicating the reason that decloaking is requested, or the
>+ empty string if no reason code was given. As per the proto-XEP,
>+ well-known values are 'media' (remote contact wants to call local
>+ user), 'text' (remote contact wants to establish a text messaging
>+ session, perhaps end-to-end encrypted), and 'file' (remote contact
>+ wants to send the local user a file).
>+ </tp:docstring>
>+ </arg>
>+
>+ <arg name="Decloaked" type="b">
>+ <tp:docstring>
>+ If true, the connection manager automatically disclosed the local user's
>+ capabilities and basic presence in response to the request, and this
>+ signal is merely for information. If false, presence was not
>+ automatically disclosed; a user interface MAY respond by calling
>+ <tp:member-ref>SendDirectedPresence</tp:member-ref>.
>+ </tp:docstring>
>+ </arg>
>+ </signal>
>+
>+ <method name="SendDirectedPresence"
>+ tp:name-for-bindings="Send_Directed_Presence">
>+ <tp:docstring>
>+ Send directed presence to a contact. This MAY be called at any time,
>+ but will typically be used as a response to
>+ <tp:member-ref>DecloakRequested</tp:member-ref>
>+ </tp:docstring>
>+
>+ <arg direction="in" name="Contact" type="u" tp:type="Contact_Handle">
>+ <tp:docstring>
>+ The contact to send directed presence to.
>+ </tp:docstring>
>+ </arg>
>+
>+ <arg direction="in" name="Full" type="b">
>+ <tp:docstring>
>+ If true, full presence (status, message, avatar hash etc.) will be
>+ directed to the specified contact. If false, only capabilities and
>+ the fact that the user is online at all will be directed to the
>+ specified contact (the local user will appear to that contact as
>+ being in 'available' status).
>+ </tp:docstring>
>+ </arg>
>+ </method>
>+
>+ </interface>
>+</node>
>+
>diff --git a/spec/all.xml b/spec/all.xml
>index 9834eb0..b5a66df 100644
>--- a/spec/all.xml
>+++ b/spec/all.xml
>@@ -82,6 +82,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
> <xi:include href="Connection_Interface_Client_Types.xml"/>
> <xi:include href="Connection_Interface_Contact_Capabilities.xml"/>
> <xi:include href="Connection_Interface_Contact_Info.xml"/>
>+ <xi:include href="Connection_Interface_Decloak1.xml"/>
> <xi:include href="Connection_Interface_Location.xml"/>
> <xi:include href="Connection_Interface_Presence.xml"/>
> <xi:include href="Connection_Interface_Renaming.xml"/>
>-- 
>1.8.4.rc3
>

Actions: View | Splinter Review

Attachments on bug 70382: 87473 | 87475 | 93602 | 93603

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.