Attachment 85927 Details for Bug 69431 – [spec next] Snapshot 0.99.1

[patch] [spec next] Snapshot 0.99.1

0001-Snapshot-0.99.1.patch (text/plain), 33.36 KB, created by Simon McVittie on 2013-09-16 17:15:34 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2013-09-16 17:15:34 UTC

Size: 33.36 KB

patch

obsolete

>From 970ea35a972acda87c56fde07a8fca2013cdbf7c Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>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 <tp:value-ref> 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 <tp:value-ref> 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">
> 
> <tp:title>Telepathy D-Bus Interface Specification</tp:title>
>-<tp:version>0.99.0.1</tp:version>
>+<tp:version>0.99.1</tp:version>
> 
>-<tp:copyright>Copyright Â© 2005-2012 Collabora Limited</tp:copyright>
>+<tp:copyright>Copyright Â© 2005-2013 Collabora Limited</tp:copyright>
> <tp:copyright>Copyright Â© 2005-2011 Nokia Corporation</tp:copyright>
> <tp:copyright>Copyright Â© 2006 INdT</tp:copyright>
> 
>-- 
>1.8.4.rc3
>

Actions: View | Splinter Review

Attachments on bug 69431: 85926 | 85927 | 85929

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.