[next] telepathy-spec: A.I.Hidden, AM.I.Hidden: remove
Guillaume Desmottes
gdesmott at kemper.freedesktop.org
Tue Jan 14 09:13:39 PST 2014
Module: telepathy-spec
Branch: next
Commit: 023eb15ee4b2e761cd9e1206ddce419cba4fad73
URL: http://cgit.freedesktop.org/telepathy/telepathy-spec/commit/?id=023eb15ee4b2e761cd9e1206ddce419cba4fad73
Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date: Mon Nov 4 16:39:44 2013 +0000
A.I.Hidden, AM.I.Hidden: remove
They were added as drafts in 2011 and never undrafted.
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=33101
---
spec/Account_Interface_Hidden1.xml | 65 ------------------
spec/Account_Manager_Interface_Hidden1.xml | 100 ----------------------------
spec/all.xml | 2 -
3 files changed, 167 deletions(-)
diff --git a/spec/Account_Interface_Hidden1.xml b/spec/Account_Interface_Hidden1.xml
deleted file mode 100644
index 431e361..0000000
--- a/spec/Account_Interface_Hidden1.xml
+++ /dev/null
@@ -1,65 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Account_Interface_Hidden1"
- 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">
- <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="im.telepathy.v1.Account.Interface.Hidden1"
- tp:causes-havoc="outrageous">
- <tp:added version="0.21.10">(draft 1)</tp:added>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>An interface for flagging certain accounts as hidden, so that they do
- not appear in the account manager's standard lists of accounts.
- Accounts whose <tp:member-ref>Hidden</tp:member-ref> property is
- <code>True</code> are intended for non-interactive use (by
- non-user-visible services), and appear on the <tp:dbus-ref
- namespace='imt1'>AccountManager.Interface.Hidden1</tp:dbus-ref>
- interface; in all other respects, they behave like any other
- account.</p>
-
- <tp:rationale>
- <p>XMPP, in particular, is increasingly used for purposes other than
- instant messaging and VoIP. For instance, extensions exist for
- inter-device bookmark synchronization.</p>
-
- <p>While obviously these services could re-use connections intended for
- instant messaging, in some cases you might want to use a different
- account. (Perhaps your bookmark sync provider is not your IM
- provider.) This API allows such auxiliary accounts to exist in
- Telepathy, while not being displayed in standard user interfaces for
- IM, VoIP, and friends.</p>
- </tp:rationale>
- </tp:docstring>
-
- <property name="Hidden" tp:name-for-bindings="Hidden"
- type="b" access="read" tp:immutable='aye'>
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If <code>True</code>, this account is intended for non-interactive
- use, and thus should not be presented to the user. It will not appear
- in properties and signals on the main <tp:dbus-ref
- namespace='imt1'>AccountManager</tp:dbus-ref> interface; instead, it
- will show up on <tp:dbus-ref
- namespace='imt1'>AccountManager.Interface.Hidden1</tp:dbus-ref>.</p>
- </tp:docstring>
- </property>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/spec/Account_Manager_Interface_Hidden1.xml b/spec/Account_Manager_Interface_Hidden1.xml
deleted file mode 100644
index c63df8d..0000000
--- a/spec/Account_Manager_Interface_Hidden1.xml
+++ /dev/null
@@ -1,100 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Account_Manager_Interface_Hidden1"
- 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="im.telepathy.v1.AccountManager.Interface.Hidden1"
- tp:causes-havoc='kind of sketchy'>
- <tp:requires interface='im.telepathy.v1.AccountManager'/>
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>This interface lists accounts whose <tp:dbus-ref
- namespace='imt1.Account.Interface.Hidden1'>Hidden</tp:dbus-ref>
- property is <code>True</code>.</p>
- </tp:docstring>
- <tp:added version="0.21.10">first draft</tp:added>
-
- <property name="UsableHiddenAccounts" type="ao" access="read"
- tp:name-for-bindings="Usable_Hidden_Accounts">
- <tp:docstring>
- A list of valid (complete, usable) <tp:dbus-ref
- namespace="im.telepathy.v1">Account</tp:dbus-ref>s intended
- exclusively for noninteractive applications. These accounts are not
- included in <tp:dbus-ref
- namespace='imt1'>AccountManager.UsableAccounts</tp:dbus-ref>. Change
- notification is via
- <tp:member-ref>HiddenAccountUsabilityChanged</tp:member-ref>.
- </tp:docstring>
- </property>
-
- <property name="UnusableHiddenAccounts" type="ao" access="read"
- tp:name-for-bindings="Unusable_Hidden_Accounts">
- <tp:docstring>
- A list of incomplete or otherwise unusable <tp:dbus-ref
- namespace="im.telepathy.v1">Account</tp:dbus-ref>s intended
- exclusively for noninteractive applications. Change notification is via
- <tp:member-ref>HiddenAccountUsabilityChanged</tp:member-ref>.
- </tp:docstring>
- </property>
-
- <signal name="HiddenAccountRemoved"
- tp:name-for-bindings="Hidden_Account_Removed">
- <tp:docstring>
- The given account has been removed from
- <tp:member-ref>UsableHiddenAccounts</tp:member-ref> or
- <tp:member-ref>UnusableHiddenAccounts</tp:member-ref>.
- </tp:docstring>
-
- <arg name="Account" type="o">
- <tp:docstring>
- An Account, which must not be used any more.
- </tp:docstring>
- </arg>
- </signal>
-
- <signal name="HiddenAccountUsabilityChanged"
- tp:name-for-bindings="Hidden_Account_Usability_Changed">
- <tp:docstring>
- The validity of the given account has changed. New magic
- accounts are also indicated by this signal, as an account validity
- change (usually to True) on an account that did not previously exist.
-
- <tp:rationale>
- This is effectively change notification for the valid and invalid
- accounts lists.
- </tp:rationale>
- </tp:docstring>
-
- <arg name="Account" type="o">
- <tp:docstring>
- An <tp:dbus-ref
- namespace="im.telepathy.v1">Account</tp:dbus-ref>.
- </tp:docstring>
- </arg>
-
- <arg name="Usable" type="b">
- <tp:docstring>
- True if the account is now valid.
- </tp:docstring>
- </arg>
- </signal>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/spec/all.xml b/spec/all.xml
index 650e3d4..abd3c29 100644
--- a/spec/all.xml
+++ b/spec/all.xml
@@ -259,11 +259,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</p>
</tp:docstring>
<xi:include href="Account_Manager.xml"/>
- <xi:include href="Account_Manager_Interface_Hidden1.xml"/>
<xi:include href="Account.xml"/>
<xi:include href="Account_Interface_Addressing1.xml"/>
<xi:include href="Account_Interface_Avatar1.xml"/>
- <xi:include href="Account_Interface_Hidden1.xml"/>
<xi:include href="Account_Interface_Storage1.xml"/>
<xi:include href="Account_Interface_External_Password_Storage1.xml"/>
</tp:section>
More information about the telepathy-commits
mailing list