diff options
Diffstat (limited to 'spec/Account_Manager_Interface_Hidden.xml')
| -rw-r--r-- | spec/Account_Manager_Interface_Hidden.xml | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/spec/Account_Manager_Interface_Hidden.xml b/spec/Account_Manager_Interface_Hidden.xml new file mode 100644 index 000000000..284eb6428 --- /dev/null +++ b/spec/Account_Manager_Interface_Hidden.xml @@ -0,0 +1,100 @@ +<?xml version="1.0" ?> +<node name="/Account_Manager_Interface_Hidden" + 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.AccountManager.Interface.Hidden.DRAFT1" + tp:causes-havoc='kind of sketchy'> + <tp:requires interface='org.freedesktop.Telepathy.AccountManager'/> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>This interface lists accounts whose <tp:dbus-ref + namespace='ofdT.Account.Interface.Hidden.DRAFT1'>Hidden</tp:dbus-ref> + property is <code>True</code>.</p> + </tp:docstring> + <tp:added version="0.21.10">first draft</tp:added> + + <property name="ValidHiddenAccounts" type="ao" access="read" + tp:name-for-bindings="Valid_Hidden_Accounts"> + <tp:docstring> + A list of valid (complete, usable) <tp:dbus-ref + namespace="org.freedesktop.Telepathy">Account</tp:dbus-ref>s intended + exclusively for noninteractive applications. These accounts are not + included in <tp:dbus-ref + namespace='ofdT'>AccountManager.ValidAccounts</tp:dbus-ref>. Change + notification is via + <tp:member-ref>HiddenAccountValidityChanged</tp:member-ref>. + </tp:docstring> + </property> + + <property name="InvalidHiddenAccounts" type="ao" access="read" + tp:name-for-bindings="Invalid_Hidden_Accounts"> + <tp:docstring> + A list of incomplete or otherwise unusable <tp:dbus-ref + namespace="org.freedesktop.Telepathy">Account</tp:dbus-ref>s intended + exclusively for noninteractive applications. Change notification is via + <tp:member-ref>HiddenAccountValidityChanged</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>ValidHiddenAccounts</tp:member-ref> or + <tp:member-ref>InvalidHiddenAccounts</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="HiddenAccountValidityChanged" + tp:name-for-bindings="Hidden_Account_Validity_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="org.freedesktop.Telepathy">Account</tp:dbus-ref>. + </tp:docstring> + </arg> + + <arg name="Valid" 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: --> |