diff options
author | Senko Rasic <senko.rasic@collabora.co.uk> | 2010-08-25 11:49:18 +0200 |
---|---|---|
committer | Senko Rasic <senko.rasic@collabora.co.uk> | 2010-08-25 13:15:10 +0200 |
commit | 0d421a714551f2a336f895a9b1073b0cf5206840 (patch) | |
tree | b7ca08940277032ebd6193564ebe783a2dde0321 /xml | |
parent | 341e252241769f8e55eba57661e9e12814526870 (diff) |
add Account_Interface_Minimum_Presence.xml
Diffstat (limited to 'xml')
-rw-r--r-- | xml/Account_Interface_Minimum_Presence.xml | 86 | ||||
-rw-r--r-- | xml/nmc5.xml | 1 |
2 files changed, 87 insertions, 0 deletions
diff --git a/xml/Account_Interface_Minimum_Presence.xml b/xml/Account_Interface_Minimum_Presence.xml new file mode 100644 index 00000000..7b6fc6c2 --- /dev/null +++ b/xml/Account_Interface_Minimum_Presence.xml @@ -0,0 +1,86 @@ +<?xml version="1.0" ?> +<node name="/Account_Interface_Minimum_Presence" + xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"> + <tp:copyright>Copyright © 2010 Collabora Ltd.</tp:copyright> + <tp:copyright>Copyright © 2010 Nokia Corporation</tp:copyright> + <tp:license xmlns="http://www.w3.org/1999/xhtml"> +<p>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.</p> + +<p>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.</p> + +<p>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. +</p> + </tp:license> + <interface name="org.freedesktop.Telepathy.Account.Interface.MinimumPresence.DRAFT" + tp:causes-havoc="experimental"> + <tp:requires interface="org.freedesktop.Telepathy.Account"/> + <tp:added version="0.19.UNRELEASED">(draft 1)</tp:added> + + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>This interface extends the core Account interface to provide a way + for applications to request minimum presence on the account.</p> + + <tp:rationale> + <p>Some applications, for example mail notifiers or address book + synchronisation, can make use of account's connection even while + the user is nominally offline.</p> + </tp:rationale> + </tp:docstring> + + <property name="Requests" tp:name-for-bindings="Requests" access="read" + type="a{s(uss)}" tp:type="Minimum_Presence_Request_Map"> + <tp:docstring> + Active requests for minimum presence status, a map of bus name to + requested presence. + </tp:docstring> + </property> + + <method name="Request" tp:name-for-bindings="Request"> + <tp:docstring> + <p>Request a minimum presence status on this account.</p> + </tp:docstring> + + <arg direction="in" name="status" type="(uss)" tp:type="Simple_Presence"> + <tp:docstring> + Requested presence status. + </tp:docstring> + </arg> + + <tp:possible-errors> + <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable"/> + </tp:possible-errors> + </method> + + <method name="Release" tp:name-for-bindings="Release"> + <tp:docstring> + <p>Release request for minimum presence status on this account + requested by this caller.</p> + </tp:docstring> + </method> + + <tp:mapping name="Minimum_Presence_Request_Map"> + <tp:docstring> + <p>A map of active minimum presence requests.</p> + </tp:docstring> + <tp:member type="s" name="Key" tp:type="DBus_Unique_Name"> + <tp:docstring> + <p>Client unique name.</p> + </tp:docstring> + </tp:member> + <tp:member type="(uss)" name="Value" tp:type="Simple_Presence"> + <tp:docstring> + <p>Requested minimum presence.</p> + </tp:docstring> + </tp:member> + </tp:mapping> + </interface> +</node> +<!-- vim:set sw=2 sts=2 et ft=xml: --> diff --git a/xml/nmc5.xml b/xml/nmc5.xml index 008c1547..269d090f 100644 --- a/xml/nmc5.xml +++ b/xml/nmc5.xml @@ -10,6 +10,7 @@ <xi:include href="Account_Interface_Compat.xml"/> <xi:include href="Account_Interface_Conditions.xml"/> <xi:include href="Account_Interface_Stats.xml"/> +<xi:include href="Account_Interface_Minimum_Presence.xml"/> <xi:include href="Account_Manager.xml"/> <xi:include href="Account_Manager_Interface_Query.xml"/> <xi:include href="Account_Manager_Interface_SSO.xml"/> |