From 970ea35a972acda87c56fde07a8fca2013cdbf7c Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Mon, 16 Sep 2013 17:54:13 +0100 Subject: [PATCH] Snapshot 0.99.1 Replace the NEWS file with some porting notes. --- NEWS | 510 ++++++++++++----------------------------------------------- NEWS-0.x | 406 +++++++++++++++++++++++++++++++++++++++++++++++ spec/all.xml | 4 +- 3 files changed, 512 insertions(+), 408 deletions(-) rewrite NEWS (99%) create mode 100644 NEWS-0.x diff --git a/NEWS b/NEWS dissimilarity index 99% index 791d555..83a88c7 100644 --- a/NEWS +++ b/NEWS @@ -1,406 +1,104 @@ -This file contains the same edited highlights as the announcement emails. -For full details, see the ChangeLog in tarballs, or "git log" in Git -checkouts. - -telepathy-spec 0.27.1 (2013-09-16) -================================== - -The “substitute burger buns” release. - -Changes: - -• The handle-name property in room lists' room details is now mandatory - (Xavier) - -New stable API: - -• Account.Interface.Addressing has change-notification via the standard - D-Bus Properties.PropertiesChanged signal (fd.o #40393, Guillaume) - -Clarifications: - -• More Tubes properties are marked up as immutable (Will) - -telepathy-spec 0.27.0 (2012-05-09) -================================== - -This is the first release in the 0.27 development branch. - -Changes since 0.26.0: - -• Mark ConnectionManager's Protocols and Protocol.I.Presence's Statuses - properties immutable (Andre Moreira Magalhae) - -• Add GetContactByID to get contact attributes for a single contact identifier - (Xavier Claessens) - -telepathy-spec 0.26.0 (2012-04-02) -================================== - -This is the start of a new stable branch of the Telepathy -specification. - -Changes since 0.25.2: - -• Small miscellaneous fixes to Call-related interfaces. - -Other notable changes since the 0.24 stable branch: - -• The Call1 family of interfaces is now considered stable after - substantial from previous drafts. - -• A Metadata file transfer interface has been added to transfer extra - data about a transfer in the channel. - -• A Picture channel interface has been added to retrieve and set - pictures for text channels and calls. - -telepathy-spec 0.25.2 (2012-02-20) -================================== - -The "you know what they said? Well, some of it was true" release. - -New stable API: - -• The Call1 family of interfaces (except for the Mute interface) is now - considered stable, with significant changes since 0.25.1: - - · Content.Removed signal removed, use Call1.ContentRemoved instead - · Content.I.DTMF added; this supersedes everything in Channel.I.DTMF - except the InitialTones property - · Various redundant contact handles removed from Content.I.Media - · MediaDescription.Reject has an "in" argument, not a nonsensical "out" - argument - · Stream.I.Media no longer has Pending_Pause or Paused states - · The Ringing state has been renamed to Initialising to avoid confusion - with the Ringing flag - · Call1.AddContent takes an initial direction as its new last parameter - · Call_Flag_Locally_Muted has been removed and the other Call_Flags - have been renumbered - · Call_Member_Flag_Ringing has been removed and the other Call_Member_Flags - have been renumbered - · The destination of a forwarded call is published in the CallStateDetails, - rather than abusing the Actor member of CallStateReason - -• Connection.I.Addressing1 is now stable, and identical to - Connection.I.Addressing.DRAFT in 0.25.1 except for its name - -• Account.Supersedes has been added - -• Connection.I.ContactList.DownloadAtConnection has been added, together with - the Download method - -• A serialization has been defined for arrays of object path in .manager - files (and by extension, anything sharing that format) - -Clarifications: - -• Account.Service should also be used for IRC networks - -• Channel.I.DTMF.InitialTones should only be used in conjunction with - InitialAudio=TRUE - -• The policy for versioned interfaces is now documented - -Changes to experimental API: - -• Channel.I.Addressing1 is the new name for Channel.I.Addressing.DRAFT, - but is still considered experimental - -telepathy-spec 0.25.1 (2011-11-23) -================================== - -The “farewell whiskey chess” release. - -API additions and clarifications: - -• Call1.Content.Interface.AudioControl is a wonderful new interface to - allow the connection manager to recommend volume changes during calls. - -• The various values of Socket_Access_Control have enjoyed some - clarification of their meanings on different tube types. - -• Protocol.Interface.Addressing has been undrafted, with NormalizeURI - renamed to NormalizeContactURI. - -• Connection.Interface.Addressing is still a draft, but its methods have - been changed to split the return values into two mappings. - -telepathy-spec 0.25.0 (2011-11-10) -================================== - -API additions and clarifications: - -• Channel.Interface.FileTransfer.Metadata has been added. - -• Channel.Interface.Picture has been added. - -• "windows-live" has been added as a known account service name. - -• Channel.Interface.Subject: clarify default values for properties in - the unknown case. - -• RoomConfig: add a PasswordHint property which does what you think it - does. - -• Room: add Creator, CreatorHandle and CreationTimestamp properties. - -• Channel.Type.ContactList has been deprecated. - -telepathy-spec 0.24.0 (2011-10-10) -================================== - -The “underestimating the future” release. This is the start of a new -stable branch of the Telepathy specification. - -Changes since 0.23.4: - -• Channel.Interface.Room has been undrafted, with a few changes: - · The RoomID property has become RoomName; - · The Subject property has been split off onto a separate interface, - Channel.Interface.Subject (which is also undrafted). - -• Channel.Interface.RoomConfig has been defined to replace the remaining - klunky Telepathy.Properties on Channel.Type.Text. - -• As a result, the Telepathy.Properties interface has been deprecated, - since all interfaces which historically used it now have better - replacements. - -Other notable changes since the 0.22 stable branch: - -• Most interfaces now provide both handles and identifiers for contacts. - This makes life easier for telepathy-glib and telepathy-qt4 (and, by - extension, application authors). - -• A new revision of the Call family of interfaces has landed. It is - still marked experimental. - -• ChannelDispatcher has a pair of new methods, DelegateChannels() and - PresentChannel(), to aid user interfaces where channels can be shown - in a number of places (like Gnome 3). - -• FileTransfer now has a URI property to indicate the on-disk location - of the file being sent or received. - -telepathy-spec 0.23.4 (2011-09-29) -================================== - -API additions and clarifications: - -• Always give contact identifiers together with handles in - Channel.Interface.Group. This helps clients to create contact objects without - extra async operations. Additions are: - • Channel.Interface.Group.MemberIdentifiers; - • Channel.Interface.Group.SelfContactChanged; and - • Channel.Interface.Group.HandleOwnersChangedDetailed. - -• AccountManager: remove note about service activation. Mission Control is - service-activatable and is probably the only implementation we'll ever have. - -• Clarify possible errors returned by AM.CreateAccount. - -Spec HTML improvements: - -• Now is used to reference a value in a enumeration. - -Call DRAFT2 landed - -• Call interfaces are now versioned. For example - org.freedesktop.Telepathy.Channel.Type.Call.DRAFT is now renamed to - org.freedesktop.Telepathy.Channel.Type.Call1. - -telepathy-spec 0.23.3 (2011-07-14) -================================== - -API additions and clarifications: - -• The semantics of the 'supersedes' header in Messages have been clarified, and - 'original-message-sent' and 'original-message-received' headers have been - defined to make the timestamps used for message edits unambiguous. - (fd.o#37413, David) - -• A tonne of properties on FileTransfer have been marked as requestable and/or - immutable. Also, as a clarification, the spec now explicitly says that - approvers may set the URI property, and that handlers MUST obey this. - (Xavier) - -• A new ChannelRequest hint, DelegateToPreferredHandler, has been added. - (fd.o#38240, Danni) - -Spec HTML improvements: - -• Jumping to anchors within the spec HTML will no longer move the text you're - looking for underneath the title bar with Webkit. Yay! (Danni (my heroine)) - -• The generated HTML spec now has a beautiful favicon. (fd.o#38594, Guillaume) - -And for spec developers: - -• `make upload-branch` now takes an optional UPLOAD_BRANCH_TO Makefile - variable, which allows you to override the default server, namely - “people.freedesktop.org” (João Paulo Rechi Vita) - -telepathy-spec 0.23.2 (2011-05-16) -================================== - -Changes to existing API ------------------------ - -• ChannelDispatcher.DelegateChannels() now calls HandleChannels once per - Channel. It also returns the list of Channels which have been delegated - and those which have not. (fdo #37109, Guillaume) - -telepathy-spec 0.23.1 (2011-05-09) -================================== - -This first release in the 0.23 development branch contains all the fixes and -additions from 0.22.3. - -Enhancements: - -• Channel.Interface.SMS.GetSMSLength() to allow SMS message chunking to be - shown to the user. (Danni) - -• ChannelDispatcher.DelegateChannels() to move channels between handlers. - (fdo #25293, Guillaume) - -• ChannelDispatcher.PresentChannel(): convenient API to re-ensure an existing - channel. (fdo #25293, Guillaume) - - -telepathy-spec 0.22.3 (2011-05-09) -================================== - -Fixes: - -• Correct DBus_Property-parameter boilerplate. (fdo #37005, Will) - -telepathy-spec 0.22.2 (2011-04-20) -================================== - -The “every cell stayed the same” release. - -Once again, this release in the stable series includes some minor API -additions. - -Enhancements: - -• Channel.Interface.SMS now includes some sample contact capabilities. - (Danni) - -• Connection.Interface.Balance now has a ManageCreditURI property. - (fd.o#36254, Danni) - -• Connection.Interface.SimplePresence now has a - MaximumStatusMessageLength property. (fd.o#33054, André) - -• SimplePresence defines two new well-known status identifiers: "pstn" - and "chat". (fd.o#36159, Danni vs. Will) - -Fixes: - -• Protocol.Interface.Avatars properties are documented to be immutable. - (Guillaume) - -• The tables in SimplePresence and Call's HTML documentation look nicer. - -telepathy-spec 0.22.1 (2011-03-30) -================================== - -The “we can change the things we know” release. - -Unconventionally, this release in the 0.22 stable series of the -specification contains minor API additions. This is not intended to -become a trend; once major changes land in the specification and a -release is made in the 0.23.x unstable series, no new API will be added -to the stable branch. - -• A new error code, InsufficientBalance, has been added, along with a - balance-required key for the CallStateDetails dictionary. (Danni) - -• Media.StreamHandler has grown two new method/signal pairs, namely - SetRemoteFeedbackMessages/SupportedFeedbackMessages and - SetRemoteHeaderExtensions/SupportedHeaderExtensions, plus some related - types, for enabling exciting RTP header extensions and RTCP feedback - messages. - -telepathy-spec 0.22.0 (2011-03-21) -================================== - -The “literate small talk” release. - -This is a new stable version of telepathy-spec, intended to serve as a -reference point for future work. There were no API changes since -development release 0.21.13; significant additions and changes to -non-DRAFT interfaces from the year-and-a-half of development since -0.20.0 are summarized below. - -The versions of libraries, connection managers and Mission Control -recommended for use with GNOME 3.0 (such as the upcoming telepathy-glib -0.14) can be expected to support most of the API from this spec release. - -Changes to existing API ------------------------ - -• Handles are no longer expected to be reference-counted - instead, they - persist as long as the Connection does. A new property, - HasImmortalHandles, indicates whether this is the case. Versions of - telepathy-glib since 0.13.8 implement these semantics, and set that - property, automatically for most connection managers. - -• message-token has been redefined from "globally unique" - to "whatever's in the underlying protocol", replacing the unimplemented - protocol-token. This makes it feasible to implement message-token again. - Note that connection managers implementing message-token should not be - backported to Maemo 5, since its event logger assumes that message-token - is guaranteed to be unique, which is usually unimplementable. - -• The Messages interface is now mandatory for Text channels. - -Enhancements to core API ------------------------- - -• The Connection has a pair of new methods, AddClientInterest and - RemoveClientInterest, to allow clients to subscribe to potentially - bandwidth-costly interfaces (such as MailNotification) in a generic - way. - -• ChannelDispatcher and ChannelRequest now support "request hints" - (metadata passed through from the requester to the handler), and the - SucceededWithChannel signal. - -New optional interfaces ------------------------ - -• The ContactList and ContactGroups interfaces for - connections are now considered stable, and a new ContactBlocking - interface has been added. Between them, these interfaces replace - ContactList channels. - -• The Connection.Interface.ClientTypes, - Connection.Interface.MailNotification, - Connection.Interface.Powersaving, and Protocol.Interface.Presence - interfaces are now considered stable. - -• Chan.T.ServerAuthentication and Chan.I.SASLAuthentication provide - interactive querying for credentials, allowing connection without - saving a password if there is a handler for these channels - -• Chan.I.Securable indicates whether a channel is secure - -• Account.Interface.Addressing stores user preferences for use of - accounts for non-primary protocols, such as using SIP for telephony. - -Enhancements to optional interfaces ------------------------------------ - -• Add a FileTransfer.URI property which can be used to tell other - Telepathy clients about the location of the transferred - file. - -Changes since 0.21.13 ---------------------- - -• A server-message key for the Details dictionary in the ConnectionError - signal has been defined. (wjt) +Telepathy 0.99.1 (2013-09-16) +============================= + +This is the first snapshot towards Telepathy 1, a new major version of +Telepathy. It is not usable yet - we're releasing this snapshot so we +have a reference point for converting everything else. + +The aims of Telepathy 1 include: + +• Don't have many deprecated ways to do the same thing +• Reduce complexity +• Increase agility by making it less painful to add D-Bus API +• Increase agility by making it less painful to break D-Bus API - + it shouldn't take 8 years to get from Telepathy 1 to Telepathy 2 + +We're not there yet, but we're getting there. + +Major changes: + +• The top-level namespace org.freedesktop.Telepathy is now the much + shorter im.telepathy1 + +• A few interfaces are considered to be "core". After Telepathy + 1 becomes stable, they will only break API in a new major version + (im.telepathy2): + + · Account, Connection, Channel and other "top-level" objects + · Channel.Type.Text + +• The majority of interfaces are considered to be "extra". If we make + incompatible changes to them, we'll renumber them (e.g. + Channel.Type.Call1 might be replaced by Channel.Type.Call2 in future). + +• InspectHandles no longer exists, and anything that gives a handle should + also give an identifier. + +• RequestHandles no longer exists, superseded by GetContactAttributes, + GetContactByID or by requesting a Room channel by its TargetID. + +• The Text and Messages interfaces have been turned into a unified + Text interface, whose API is basically the old Messages interface. + +Smaller changes: + +• "valid Accounts" are now "usable Accounts" to avoid clashing with + the idea of proxy objects' validity, or weak pointers' validity + +• various data-types related to SimplePresence have dropped the "Simple" + prefix + +• Protocol names and Service names may now contain underscores, but not + hyphen-minus (so telepathy-salut implements local_xmpp, not local-xmpp, + while telepathy-gabble now communicates with services that include + google_talk, lj_talk and windows_live) + +• There are no more 16-bit integers, even for port numbers. We use + 32- or 64-bit integers throughout. + +• ChannelDispatcher.CreateChannel, EnsureChannel are similar to the old + CreateChannelWithHints, EnsureChannelWithHints, but they also + return the ChannelRequest's immutable properties. The versions with + fewer arguments have been removed. + +• Group.MembersChanged now has the same arguments previously used by + MembersChangedDetailed, which has been deleted. + +• ChannelRequest.Succeeded has the extra arguments previously in + SucceededWithHints, which has been deleted. + +• Conn.I.ContactList.ContactsChanged has the extra arguments previously in + ContactsChangedWithID, which has been deleted. + +• Client names may start with underscores + +• Access_Control_Type_Group takes a string group name, not a handle. + +• AliasesChanged contains a map from contact handle to alias, + not an array of pairs. + +Deprecated things that were deleted include: + +• "Telepathy Properties" (replaced by standard D-Bus properties) + +• Capabilities (replaced by ContactCapabilities) + +• Presence (replaced by SimplePresence) + +• StreamedMedia channels (replaced by Call channels) + +• ContactList channels (replaced by Conn.I.ContactList, Conn.I.ContactGroups) + and Handles of type LIST or GROUP + +• Tubes channels (replaced by StreamTube, DBusTube channels) + +• Many methods of the form GetFoo() (replaced by corresponding properties, + or by GetContactAttributes) + +• ChannelHandler + +• HoldHandles, ReleaseHandles + +• ListChannels, NewChannel, RequestChannel (replaced by Conn.I.Requests) + +• Various interfaces that never got beyond draft status diff --git a/NEWS-0.x b/NEWS-0.x new file mode 100644 index 0000000..791d555 --- /dev/null +++ b/NEWS-0.x @@ -0,0 +1,406 @@ +This file contains the same edited highlights as the announcement emails. +For full details, see the ChangeLog in tarballs, or "git log" in Git +checkouts. + +telepathy-spec 0.27.1 (2013-09-16) +================================== + +The “substitute burger buns” release. + +Changes: + +• The handle-name property in room lists' room details is now mandatory + (Xavier) + +New stable API: + +• Account.Interface.Addressing has change-notification via the standard + D-Bus Properties.PropertiesChanged signal (fd.o #40393, Guillaume) + +Clarifications: + +• More Tubes properties are marked up as immutable (Will) + +telepathy-spec 0.27.0 (2012-05-09) +================================== + +This is the first release in the 0.27 development branch. + +Changes since 0.26.0: + +• Mark ConnectionManager's Protocols and Protocol.I.Presence's Statuses + properties immutable (Andre Moreira Magalhae) + +• Add GetContactByID to get contact attributes for a single contact identifier + (Xavier Claessens) + +telepathy-spec 0.26.0 (2012-04-02) +================================== + +This is the start of a new stable branch of the Telepathy +specification. + +Changes since 0.25.2: + +• Small miscellaneous fixes to Call-related interfaces. + +Other notable changes since the 0.24 stable branch: + +• The Call1 family of interfaces is now considered stable after + substantial from previous drafts. + +• A Metadata file transfer interface has been added to transfer extra + data about a transfer in the channel. + +• A Picture channel interface has been added to retrieve and set + pictures for text channels and calls. + +telepathy-spec 0.25.2 (2012-02-20) +================================== + +The "you know what they said? Well, some of it was true" release. + +New stable API: + +• The Call1 family of interfaces (except for the Mute interface) is now + considered stable, with significant changes since 0.25.1: + + · Content.Removed signal removed, use Call1.ContentRemoved instead + · Content.I.DTMF added; this supersedes everything in Channel.I.DTMF + except the InitialTones property + · Various redundant contact handles removed from Content.I.Media + · MediaDescription.Reject has an "in" argument, not a nonsensical "out" + argument + · Stream.I.Media no longer has Pending_Pause or Paused states + · The Ringing state has been renamed to Initialising to avoid confusion + with the Ringing flag + · Call1.AddContent takes an initial direction as its new last parameter + · Call_Flag_Locally_Muted has been removed and the other Call_Flags + have been renumbered + · Call_Member_Flag_Ringing has been removed and the other Call_Member_Flags + have been renumbered + · The destination of a forwarded call is published in the CallStateDetails, + rather than abusing the Actor member of CallStateReason + +• Connection.I.Addressing1 is now stable, and identical to + Connection.I.Addressing.DRAFT in 0.25.1 except for its name + +• Account.Supersedes has been added + +• Connection.I.ContactList.DownloadAtConnection has been added, together with + the Download method + +• A serialization has been defined for arrays of object path in .manager + files (and by extension, anything sharing that format) + +Clarifications: + +• Account.Service should also be used for IRC networks + +• Channel.I.DTMF.InitialTones should only be used in conjunction with + InitialAudio=TRUE + +• The policy for versioned interfaces is now documented + +Changes to experimental API: + +• Channel.I.Addressing1 is the new name for Channel.I.Addressing.DRAFT, + but is still considered experimental + +telepathy-spec 0.25.1 (2011-11-23) +================================== + +The “farewell whiskey chess” release. + +API additions and clarifications: + +• Call1.Content.Interface.AudioControl is a wonderful new interface to + allow the connection manager to recommend volume changes during calls. + +• The various values of Socket_Access_Control have enjoyed some + clarification of their meanings on different tube types. + +• Protocol.Interface.Addressing has been undrafted, with NormalizeURI + renamed to NormalizeContactURI. + +• Connection.Interface.Addressing is still a draft, but its methods have + been changed to split the return values into two mappings. + +telepathy-spec 0.25.0 (2011-11-10) +================================== + +API additions and clarifications: + +• Channel.Interface.FileTransfer.Metadata has been added. + +• Channel.Interface.Picture has been added. + +• "windows-live" has been added as a known account service name. + +• Channel.Interface.Subject: clarify default values for properties in + the unknown case. + +• RoomConfig: add a PasswordHint property which does what you think it + does. + +• Room: add Creator, CreatorHandle and CreationTimestamp properties. + +• Channel.Type.ContactList has been deprecated. + +telepathy-spec 0.24.0 (2011-10-10) +================================== + +The “underestimating the future” release. This is the start of a new +stable branch of the Telepathy specification. + +Changes since 0.23.4: + +• Channel.Interface.Room has been undrafted, with a few changes: + · The RoomID property has become RoomName; + · The Subject property has been split off onto a separate interface, + Channel.Interface.Subject (which is also undrafted). + +• Channel.Interface.RoomConfig has been defined to replace the remaining + klunky Telepathy.Properties on Channel.Type.Text. + +• As a result, the Telepathy.Properties interface has been deprecated, + since all interfaces which historically used it now have better + replacements. + +Other notable changes since the 0.22 stable branch: + +• Most interfaces now provide both handles and identifiers for contacts. + This makes life easier for telepathy-glib and telepathy-qt4 (and, by + extension, application authors). + +• A new revision of the Call family of interfaces has landed. It is + still marked experimental. + +• ChannelDispatcher has a pair of new methods, DelegateChannels() and + PresentChannel(), to aid user interfaces where channels can be shown + in a number of places (like Gnome 3). + +• FileTransfer now has a URI property to indicate the on-disk location + of the file being sent or received. + +telepathy-spec 0.23.4 (2011-09-29) +================================== + +API additions and clarifications: + +• Always give contact identifiers together with handles in + Channel.Interface.Group. This helps clients to create contact objects without + extra async operations. Additions are: + • Channel.Interface.Group.MemberIdentifiers; + • Channel.Interface.Group.SelfContactChanged; and + • Channel.Interface.Group.HandleOwnersChangedDetailed. + +• AccountManager: remove note about service activation. Mission Control is + service-activatable and is probably the only implementation we'll ever have. + +• Clarify possible errors returned by AM.CreateAccount. + +Spec HTML improvements: + +• Now is used to reference a value in a enumeration. + +Call DRAFT2 landed + +• Call interfaces are now versioned. For example + org.freedesktop.Telepathy.Channel.Type.Call.DRAFT is now renamed to + org.freedesktop.Telepathy.Channel.Type.Call1. + +telepathy-spec 0.23.3 (2011-07-14) +================================== + +API additions and clarifications: + +• The semantics of the 'supersedes' header in Messages have been clarified, and + 'original-message-sent' and 'original-message-received' headers have been + defined to make the timestamps used for message edits unambiguous. + (fd.o#37413, David) + +• A tonne of properties on FileTransfer have been marked as requestable and/or + immutable. Also, as a clarification, the spec now explicitly says that + approvers may set the URI property, and that handlers MUST obey this. + (Xavier) + +• A new ChannelRequest hint, DelegateToPreferredHandler, has been added. + (fd.o#38240, Danni) + +Spec HTML improvements: + +• Jumping to anchors within the spec HTML will no longer move the text you're + looking for underneath the title bar with Webkit. Yay! (Danni (my heroine)) + +• The generated HTML spec now has a beautiful favicon. (fd.o#38594, Guillaume) + +And for spec developers: + +• `make upload-branch` now takes an optional UPLOAD_BRANCH_TO Makefile + variable, which allows you to override the default server, namely + “people.freedesktop.org” (João Paulo Rechi Vita) + +telepathy-spec 0.23.2 (2011-05-16) +================================== + +Changes to existing API +----------------------- + +• ChannelDispatcher.DelegateChannels() now calls HandleChannels once per + Channel. It also returns the list of Channels which have been delegated + and those which have not. (fdo #37109, Guillaume) + +telepathy-spec 0.23.1 (2011-05-09) +================================== + +This first release in the 0.23 development branch contains all the fixes and +additions from 0.22.3. + +Enhancements: + +• Channel.Interface.SMS.GetSMSLength() to allow SMS message chunking to be + shown to the user. (Danni) + +• ChannelDispatcher.DelegateChannels() to move channels between handlers. + (fdo #25293, Guillaume) + +• ChannelDispatcher.PresentChannel(): convenient API to re-ensure an existing + channel. (fdo #25293, Guillaume) + + +telepathy-spec 0.22.3 (2011-05-09) +================================== + +Fixes: + +• Correct DBus_Property-parameter boilerplate. (fdo #37005, Will) + +telepathy-spec 0.22.2 (2011-04-20) +================================== + +The “every cell stayed the same” release. + +Once again, this release in the stable series includes some minor API +additions. + +Enhancements: + +• Channel.Interface.SMS now includes some sample contact capabilities. + (Danni) + +• Connection.Interface.Balance now has a ManageCreditURI property. + (fd.o#36254, Danni) + +• Connection.Interface.SimplePresence now has a + MaximumStatusMessageLength property. (fd.o#33054, André) + +• SimplePresence defines two new well-known status identifiers: "pstn" + and "chat". (fd.o#36159, Danni vs. Will) + +Fixes: + +• Protocol.Interface.Avatars properties are documented to be immutable. + (Guillaume) + +• The tables in SimplePresence and Call's HTML documentation look nicer. + +telepathy-spec 0.22.1 (2011-03-30) +================================== + +The “we can change the things we know” release. + +Unconventionally, this release in the 0.22 stable series of the +specification contains minor API additions. This is not intended to +become a trend; once major changes land in the specification and a +release is made in the 0.23.x unstable series, no new API will be added +to the stable branch. + +• A new error code, InsufficientBalance, has been added, along with a + balance-required key for the CallStateDetails dictionary. (Danni) + +• Media.StreamHandler has grown two new method/signal pairs, namely + SetRemoteFeedbackMessages/SupportedFeedbackMessages and + SetRemoteHeaderExtensions/SupportedHeaderExtensions, plus some related + types, for enabling exciting RTP header extensions and RTCP feedback + messages. + +telepathy-spec 0.22.0 (2011-03-21) +================================== + +The “literate small talk” release. + +This is a new stable version of telepathy-spec, intended to serve as a +reference point for future work. There were no API changes since +development release 0.21.13; significant additions and changes to +non-DRAFT interfaces from the year-and-a-half of development since +0.20.0 are summarized below. + +The versions of libraries, connection managers and Mission Control +recommended for use with GNOME 3.0 (such as the upcoming telepathy-glib +0.14) can be expected to support most of the API from this spec release. + +Changes to existing API +----------------------- + +• Handles are no longer expected to be reference-counted - instead, they + persist as long as the Connection does. A new property, + HasImmortalHandles, indicates whether this is the case. Versions of + telepathy-glib since 0.13.8 implement these semantics, and set that + property, automatically for most connection managers. + +• message-token has been redefined from "globally unique" + to "whatever's in the underlying protocol", replacing the unimplemented + protocol-token. This makes it feasible to implement message-token again. + Note that connection managers implementing message-token should not be + backported to Maemo 5, since its event logger assumes that message-token + is guaranteed to be unique, which is usually unimplementable. + +• The Messages interface is now mandatory for Text channels. + +Enhancements to core API +------------------------ + +• The Connection has a pair of new methods, AddClientInterest and + RemoveClientInterest, to allow clients to subscribe to potentially + bandwidth-costly interfaces (such as MailNotification) in a generic + way. + +• ChannelDispatcher and ChannelRequest now support "request hints" + (metadata passed through from the requester to the handler), and the + SucceededWithChannel signal. + +New optional interfaces +----------------------- + +• The ContactList and ContactGroups interfaces for + connections are now considered stable, and a new ContactBlocking + interface has been added. Between them, these interfaces replace + ContactList channels. + +• The Connection.Interface.ClientTypes, + Connection.Interface.MailNotification, + Connection.Interface.Powersaving, and Protocol.Interface.Presence + interfaces are now considered stable. + +• Chan.T.ServerAuthentication and Chan.I.SASLAuthentication provide + interactive querying for credentials, allowing connection without + saving a password if there is a handler for these channels + +• Chan.I.Securable indicates whether a channel is secure + +• Account.Interface.Addressing stores user preferences for use of + accounts for non-primary protocols, such as using SIP for telephony. + +Enhancements to optional interfaces +----------------------------------- + +• Add a FileTransfer.URI property which can be used to tell other + Telepathy clients about the location of the transferred + file. + +Changes since 0.21.13 +--------------------- + +• A server-message key for the Details dictionary in the ConnectionError + signal has been defined. (wjt) diff --git a/spec/all.xml b/spec/all.xml index dbca337..7b3526c 100644 --- a/spec/all.xml +++ b/spec/all.xml @@ -3,9 +3,9 @@ xmlns:xi="http://www.w3.org/2001/XInclude"> Telepathy D-Bus Interface Specification -0.99.0.1 +0.99.1 -Copyright © 2005-2012 Collabora Limited +Copyright © 2005-2013 Collabora Limited Copyright © 2005-2011 Nokia Corporation Copyright © 2006 INdT -- 1.8.4.rc3