diff options
Diffstat (limited to 'spec/Account.xml')
-rw-r--r-- | spec/Account.xml | 31 |
1 files changed, 30 insertions, 1 deletions
diff --git a/spec/Account.xml b/spec/Account.xml index 13b97f4b5..fff0232dd 100644 --- a/spec/Account.xml +++ b/spec/Account.xml @@ -1,7 +1,7 @@ <?xml version="1.0" ?> <node name="/Account" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"> - <tp:copyright>Copyright © 2008-2009 Collabora Ltd.</tp:copyright> + <tp:copyright>Copyright © 2008-2012 Collabora Ltd.</tp:copyright> <tp:copyright>Copyright © 2008-2009 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 @@ -713,6 +713,35 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. </tp:docstring> </property> + <property name="Supersedes" tp:name-for-bindings="Supersedes" + type="ao" access="readwrite"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>A list of the object paths of formerly-used accounts which are + superseded by this one.</p> + + <tp:rationale> + <p>For instance, if an account is migrated from one connection + manager implementation to another, or even from one protocol + to another (for instance formerly-proprietary services which + can now be accessed via XMPP), log storage services could + look for logs under all of the superseded object paths as well + as the new object path.</p> + + <p>This is a list because a single user-visible account could be + migrated more than once.</p> + </tp:rationale> + + <p>If the Account Manager implementation performs an account migration + automatically, it SHOULD set this property. If a client performs + an account migration, it SHOULD set this property via + via the Properties argument of <tp:dbus-ref + namespace="ofdT.AccountManager">CreateAccount</tp:dbus-ref> + when creating the migrated account. In either case, the value + SHOULD include the old account's path, and every path from + the old account's Supersedes property.</p> + </tp:docstring> + </property> + </interface> </node> <!-- vim:set sw=2 sts=2 et ft=xml: --> |