Skip to content

GitLab

T
telepathy-spec
Commit 023eb15e authored by Simon McVittie's avatar Simon McVittie Committed by Guillaume Desmottes
Browse files
Options

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
parent 01dd4985
Hide whitespace changes
Inline Side-by-side
Showing with 0 additions and 167 deletions
spec/Account_Interface_Hidden1.xml deleted 100644 → 0
View file @ 01dd4985
<?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: -->
spec/Account_Manager_Interface_Hidden1.xml deleted 100644 → 0
View file @ 01dd4985
<?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: -->
spec/all.xml
View file @ 023eb15e
......@@ -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>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment