From 9fa3c65e038f66dcf4c28bd10a26680229c2843c Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Fri, 20 Sep 2013 12:59:50 +0100 Subject: [PATCH] Update extension interfaces to their telepathy-spec 0.27.1 versions No functional changes. The remaining interfaces (A.I.Conditions, CD.I.Messages) are still not in telepathy-spec at all. :-( --- ...Account_Interface_External_Password_Storage.xml | 20 +++++++++----- xml/Account_Interface_Hidden.xml | 25 ++++++++++++++--- xml/Account_Manager_Interface_Hidden.xml | 3 +-- ...onnection_Manager_Interface_Account_Storage.xml | 31 ++++++++++++---------- 4 files changed, 53 insertions(+), 26 deletions(-) diff --git a/xml/Account_Interface_External_Password_Storage.xml b/xml/Account_Interface_External_Password_Storage.xml index f868f65..5bd1bfc 100644 --- a/xml/Account_Interface_External_Password_Storage.xml +++ b/xml/Account_Interface_External_Password_Storage.xml @@ -22,29 +22,35 @@ - (draft 1) + (draft 1)

An interface for Accounts whose passwords are stored externally and - SHOULD NOT be stored by either the AccountManager nor - any ServerAuthentication + SHOULD NOT be stored by either the + AccountManager nor any + ServerAuthentication handler.

+ +

This interface SHOULD only appear on accounts for which the + related Connection Manager implements + ConnectionManager.Interface.AccountStorage.DRAFT.

 -

Clears any saved password associated with this account.

+ Clears any saved password associated with this account. - +

Indicates whether the account has a saved password or not.

+ +

Change notification for this property is provided by the + standard D-Bus PropertiesChanged signal.

 diff --git a/xml/Account_Interface_Hidden.xml b/xml/Account_Interface_Hidden.xml index 5457733..cb00191 100644 --- a/xml/Account_Interface_Hidden.xml +++ b/xml/Account_Interface_Hidden.xml @@ -22,11 +22,30 @@ - (draft 1) + (draft 1) -

-

+

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 Hidden property is + True are intended for non-interactive use (by + non-user-visible services), and appear on the AccountManager.Interface.Hidden.DRAFT1 + interface; in all other respects, they behave like any other + account.

+ + +

XMPP, in particular, is increasingly used for purposes other than + instant messaging and VoIP. For instance, extensions exist for + inter-device bookmark synchronization.

+ +

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.

+ Hidden property is True.

- first draft + first draft @@ -98,4 +98,3 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - diff --git a/xml/Connection_Manager_Interface_Account_Storage.xml b/xml/Connection_Manager_Interface_Account_Storage.xml index 5c7dd03..2f4f4bf 100644 --- a/xml/Connection_Manager_Interface_Account_Storage.xml +++ b/xml/Connection_Manager_Interface_Account_Storage.xml @@ -22,25 +22,25 @@ - (draft 1) + (draft 1)

An interface for connection managers that store account details internally. At the moment this consists only of storing an account's credentials, but other functionality may be added in the future.

-

Account objects + +

Account objects representing accounts on a connection manager that implements this - interface should implement the ExternalPasswordStorage.DRAFT + interface should implement the + ExternalPasswordStorage.DRAFT interface.

- - A set of flags representing the status of the Account stored in the Connection Manager. + A set of flags representing the status of the Account stored in the + Connection Manager. @@ -61,9 +61,12 @@ - - The set of Accounts stored in this connection manager, and flags - indicating their status. + +

The set of Accounts stored in this Connection Manager, and flags + indicating their status.

+ +

Change notification for this property is provided by the standard + D-Bus PropertiesChanged signal.

 @@ -76,8 +79,8 @@ - An account id as returned from Protocol.IdentifyAccount. + An account id as returned from + Protocol.IdentifyAccount. @@ -99,8 +102,8 @@ - An account id as returned from Protocol.IdentifyAccount. + An account id as returned from + Protocol.IdentifyAccount. -- 1.8.4.rc3