From cc2d22d8a23465dbb3a5b7eacea452c76c8722ec Mon Sep 17 00:00:00 2001 From: Will Thompson Date: Mon, 12 Jul 2010 18:30:01 +0100 Subject: Update to spec 0.19.9. --- spec/Channel_Interface_Messages.xml | 98 +++++++++++++++++++++++++++++------ spec/Connection_Interface_Balance.xml | 50 ++++++++++-------- spec/all.xml | 2 +- 3 files changed, 110 insertions(+), 40 deletions(-) (limited to 'spec') diff --git a/spec/Channel_Interface_Messages.xml b/spec/Channel_Interface_Messages.xml index 7bd225dfe..31cf47194 100644 --- a/spec/Channel_Interface_Messages.xml +++ b/spec/Channel_Interface_Messages.xml @@ -626,8 +626,9 @@ USA.

content-type (s)

The MIME type of this part. See the documentation - for ReceivedMessage for notes on the special status of - "text/plain" parts.

+ for MessageReceived and + MessageSent for notes on the + special status of "text/plain" parts.

Connection managers MUST NOT signal parts without a 'content-type' key; if a protocol provides no way to determine @@ -942,7 +943,11 @@ USA.

- Flags affecting how the message is sent. + Flags affecting how the message is sent. The channel MAY ignore some + or all flags, depending on + DeliveryReportingSupport; the flags + that were handled by the CM are provided in + MessageSent. @@ -971,7 +976,9 @@ USA.

type="u"> Flags altering the way a message is sent. The "most usual" action - should always be to have these flags unset. + should always be to have these flags unset. Some indication of which + flags are supported is provided by the + DeliveryReportingSupport property. @@ -991,6 +998,24 @@ USA.

messages.

 + + + + +

Provide a delivery report when the message is read by the + recipient, even if this is not the default for this protocol. + Ignored if read reports are not possible on this protocol.

+ + + + + + +

Provide a delivery report when the message is deleted by the + recipient, even if this is not the default for this protocol. + Ignored if such reports are not possible on this protocol.

+ + @@ -1151,7 +1176,12 @@ USA.

- The message content, including any attachments or alternatives +

The message content, including any attachments or alternatives. If + the incoming message contains formatted text without a plain text + alternative, the connection manager MUST generate a + text/plain alternative from the formatted text, and + include it in this message (both here, and in the + PendingMessages property).

 @@ -1224,28 +1254,49 @@ USA.

+ + + + + The message has been read by the intended recipient. + + + + + + + The message has been deleted by the intended recipient. This MAY be + signalled on its own if the message is deleted without being read, or + after Read if the message was read before being deleted. + + Flags indicating the level of support for delivery reporting on this - channel. Any future flags added to this set will conform to the + channel, as found on the + DeliveryReportingSupport property. Any + future flags added to this set will conform to the convention that the presence of an extra flag implies that - more operations will succeed. + more operations will succeed. Note that CMs may always provide more + reports than are requested in the + Message_Sending_Flags passed to + SendMessage. + + + If senders want delivery reports, they should ask for them. If they + don't want delivery reports, they can just ignore them, so there's no + need to have capability discovery for what will happen if a delivery + report isn't requested. + Clients MAY expect to receive negative delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending. - - - If senders want delivery reports, they should ask for them. - If they don't want delivery reports, they can just ignore them, - so there's no need to have capability discovery for what will - happen if a delivery report isn't requested. - @@ -1253,13 +1304,26 @@ USA.

Clients MAY expect to receive positive delivery reports if Message_Sending_Flag_Report_Delivery is specified when sending. + + - - Same rationale as Receive_Failures. - + + + + Clients MAY expect to receive Delivery_Status + Read reports if Message_Sending_Flag_Report_Read + is specified when sending. + + + + Clients MAY expect to receive Delivery_Status + Deleted reports if Message_Sending_Flag_Report_Deleted + is specified when sending. + +

An amount of money in a specified currency. For example, 3.21 British pounds would conventionally be represented by - (Amount = 321, Scale = 2, Currency = "GBP"), but could be - represented by (Amount = 3210, Scale = 3, Currency = "GBP") - in a service that records balance in units of 0.001 pounds.

+ (Amount = 321, Scale = 2, + Currency = "GBP"), but could be represented by + (Amount = 3210, Scale = 3, + Currency = "GBP") in a service that records + balance in units of 0.001 pounds.

-

As a special case, if Amount = 0, Scale = 2**32 - 1 (i.e. - the largest possible 32-bit unsigned integer) and Currency = "", - this indicates an unknown amount.

+

As a special case, if Amount = 0, + Scale = 2**32 - 1 (i.e. the largest possible + 32-bit unsigned integer) and Currency = "", this + indicates an unknown amount.

The amount, expressed as a fixed-point number with decimal scale - defined by the Scale property; for instance, an Amount value of - 1234 with Scale of 2 represents 12.34 in the currency unit given - by the Currency.

+ defined by the Scale field; for instance, an + Amount value of 1234 with Scale of + 2 represents 12.34 in the currency unit given by the + Currency field.

 -

The decimal scale for the fixed point value of the Amount - property, defining the number of rightmost decimal digits from - the integer value which form the fractional part of the resulting - currency value.

+

The decimal scale for the fixed point value of the + Amount field, defining the number of rightmost decimal + digits from the integer value which form the fractional part of the + resulting currency value.

-

As well as defining the interpretation of Amount, user interfaces - may use this value to determine the precision with which to display - the amount.

+

As well as defining the interpretation of Amount, user + interfaces may use this value to determine the precision with which + to display the amount.

 The currency code represented by this amount, which SHOULD be an - international currency code such as "EUR", "USD", or "JPY" if - possible. An empty string can be used to indicate that the currency - is not known. + international currency code such as "EUR", "USD", + or "JPY" if possible. An empty string can be used to + indicate that the currency is not known. @@ -77,13 +81,15 @@ -

The user's balance on the account corresponding to this Connection. +

The user's balance on the account corresponding to this Connection. A negative amount may be possible on some services, and indicates that the user owes money to the service provider.

On initial connection, this property may have an unknown - value, represented by Amount = 0, Scale = 2**32 - 1 (the largest - possible 32-bit unsigned integer) and Currency = "".

+ value, represented by Amount = 0, + Scale = 2**32 - 1 (the largest possible 32-bit + unsigned integer) and Currency = "".

 diff --git a/spec/all.xml b/spec/all.xml index 44d65347b..e77f63405 100644 --- a/spec/all.xml +++ b/spec/all.xml @@ -3,7 +3,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude"> Telepathy D-Bus Interface Specification -0.19.8 +0.19.9 Copyright © 2005-2010 Collabora Limited Copyright © 2005-2010 Nokia Corporation -- cgit v1.2.1