From 7ba697ce669a650f268c5d7975315b3261f97248 Mon Sep 17 00:00:00 2001 From: Simon McVittie 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 @@ + + + Copyright © 2010 Collabora Ltd. + +

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.

+
+ + + + + + + A simple D-Bus API for XEP-0276 Temporary + Presence Sharing or any compatible scheme. See the XEP for + more details. + + + + +

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.

+ + +

This is necessary to allow incoming calls from arbitrary + users.

+
+ +

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.

+
+
+ + + + Emitted when a remote contact asks for the local user's capabilities + and basic presence to be disclosed. + + + + + The contact asking for presence disclosure + + + + + + 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). + + + + + + 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 + SendDirectedPresence. + + + + + + + Send directed presence to a contact. This MAY be called at any time, + but will typically be used as a response to + DecloakRequested + + + + + The contact to send directed presence to. + + + + + + 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). + + + + +
+
+ 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. + -- 1.8.4.rc3