Snapshot 0.99.1

Replace the NEWS file with some porting notes.

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=69431
Reviewed-by: Guillaume Desmottes
[and add s/UNRELEASED/0.99.1/ -smcv]

15 files changed, 490 insertions, 389 deletions

diff --git a/NEWS b/NEWS
index 791d5550..83a88c70 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 0.99.1 (2013-09-16)
+=============================
 
-telepathy-spec 0.27.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 “substitute burger buns” release.
+The aims of Telepathy 1 include:
 
-Changes:
+• 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
 
-• The handle-name property in room lists' room details is now mandatory
-  (Xavier)
+We're not there yet, but we're getting there.
 
-New stable API:
+Major changes:
 
-• Account.Interface.Addressing has change-notification via the standard
-  D-Bus Properties.PropertiesChanged signal (fd.o #40393, Guillaume)
+• The top-level namespace org.freedesktop.Telepathy is now the much
+  shorter im.telepathy1
 
-Clarifications:
+• 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):
 
-• More Tubes properties are marked up as immutable (Will)
+  · Account, Connection, Channel and other "top-level" objects
+  · Channel.Type.Text
 
-telepathy-spec 0.27.0 (2012-05-09)
-==================================
+• 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).
 
-This is the first release in the 0.27 development branch.
+• InspectHandles no longer exists, and anything that gives a handle should
+  also give an identifier.
 
-Changes since 0.26.0:
+• RequestHandles no longer exists, superseded by GetContactAttributes,
+  GetContactByID or by requesting a Room channel by its TargetID.
 
-• Mark ConnectionManager's Protocols and Protocol.I.Presence's Statuses
-  properties immutable (Andre Moreira Magalhae)
+• The Text and Messages interfaces have been turned into a unified
+  Text interface, whose API is basically the old Messages interface.
 
-• Add GetContactByID to get contact attributes for a single contact identifier
-  (Xavier Claessens)
+Smaller changes:
 
-telepathy-spec 0.26.0 (2012-04-02)
-==================================
+• "valid Accounts" are now "usable Accounts" to avoid clashing with
+  the idea of proxy objects' validity, or weak pointers' validity
 
-This is the start of a new stable branch of the Telepathy
-specification.
+• various data-types related to SimplePresence have dropped the "Simple"
+  prefix
 
-Changes since 0.25.2:
+• 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)
 
-• Small miscellaneous fixes to Call-related interfaces.
+• There are no more 16-bit integers, even for port numbers. We use
+  32- or 64-bit integers throughout.
 
-Other notable changes since the 0.24 stable branch:
+• 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.
 
-• The Call1 family of interfaces is now considered stable after
-  substantial from previous drafts.
+• Group.MembersChanged now has the same arguments previously used by
+  MembersChangedDetailed, which has been deleted.
 
-• A Metadata file transfer interface has been added to transfer extra
-  data about a transfer in the channel.
+• ChannelRequest.Succeeded has the extra arguments previously in
+  SucceededWithHints, which has been deleted.
 
-• A Picture channel interface has been added to retrieve and set
-  pictures for text channels and calls.
+• Conn.I.ContactList.ContactsChanged has the extra arguments previously in
+  ContactsChangedWithID, which has been deleted.
 
-telepathy-spec 0.25.2 (2012-02-20)
-==================================
+• Client names may start with underscores
 
-The "you know what they said? Well, some of it was true" release.
+• Access_Control_Type_Group takes a string group name, not a handle.
 
-New stable API:
+• AliasesChanged contains a map from contact handle to alias,
+  not an array of pairs.
 
-• The Call1 family of interfaces (except for the Mute interface) is now
-  considered stable, with significant changes since 0.25.1:
+Deprecated things that were deleted include:
 
-  · 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
+• "Telepathy Properties" (replaced by standard D-Bus properties)
 
-• Connection.I.Addressing1 is now stable, and identical to
-  Connection.I.Addressing.DRAFT in 0.25.1 except for its name
+• Capabilities (replaced by ContactCapabilities)
 
-• Account.Supersedes has been added
+• Presence (replaced by SimplePresence)
 
-• Connection.I.ContactList.DownloadAtConnection has been added, together with
-  the Download method
+• StreamedMedia channels (replaced by Call channels)
 
-• A serialization has been defined for arrays of object path in .manager
-  files (and by extension, anything sharing that format)
+• ContactList channels (replaced by Conn.I.ContactList, Conn.I.ContactGroups)
+  and Handles of type LIST or GROUP
 
-Clarifications:
+• Tubes channels (replaced by StreamTube, DBusTube channels)
 
-• Account.Service should also be used for IRC networks
+• Many methods of the form GetFoo() (replaced by corresponding properties,
+  or by GetContactAttributes)
 
-• Channel.I.DTMF.InitialTones should only be used in conjunction with
-  InitialAudio=TRUE
+• ChannelHandler
 
-• The policy for versioned interfaces is now documented
+• HoldHandles, ReleaseHandles
 
-Changes to experimental API:
+• ListChannels, NewChannel, RequestChannel (replaced by Conn.I.Requests)
 
-• 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)
+• Various interfaces that never got beyond draft status
diff --git a/NEWS-0.x b/NEWS-0.x
new file mode 100644
index 00000000..791d5550
--- /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/Channel.xml b/spec/Channel.xml
index 136b0776..ef5bf5e8 100644
--- a/spec/Channel.xml
+++ b/spec/Channel.xml
@@ -397,7 +397,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       as a prefix.
     </tp:changed>
 
-    <tp:changed version="UNRELEASED">Deprecated methods
+    <tp:changed version="0.99.1">Deprecated methods
       (GetChannelType, GetHandle, and GetInterfaces) have been removed
       from this interface.</tp:changed>
   </interface>
diff --git a/spec/Channel_Interface_Group1.xml b/spec/Channel_Interface_Group1.xml
index 1204c322..ffe0af3e 100644
--- a/spec/Channel_Interface_Group1.xml
+++ b/spec/Channel_Interface_Group1.xml
@@ -20,7 +20,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
   </tp:license>
   <interface name="im.telepathy1.Channel.Interface.Group1">
     <tp:requires interface="im.telepathy1.Channel"/>
-    <tp:changed version="UNRELEASED">Deprecated methods, signals, and
+    <tp:changed version="0.99.1">Deprecated methods, signals, and
       properties have all been removed.</tp:changed>
 
     <tp:struct name="Local_Pending_Info" array-name="Local_Pending_Info_List">
diff --git a/spec/Channel_Interface_Tube1.xml b/spec/Channel_Interface_Tube1.xml
index 6a16880e..cacc2533 100644
--- a/spec/Channel_Interface_Tube1.xml
+++ b/spec/Channel_Interface_Tube1.xml
@@ -182,7 +182,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
     <tp:enum name="Socket_Access_Control" type="u"
       array-name="Socket_Access_Control_List">
-      <tp:changed version="UNRELEASED">The deprecated Netmask enum
+      <tp:changed version="0.99.1">The deprecated Netmask enum
         value has been removed.</tp:changed>
       <tp:enumvalue suffix="Localhost" value="0">
         <tp:docstring>
diff --git a/spec/Channel_Type_Contact_Search1.xml b/spec/Channel_Type_Contact_Search1.xml
index 4c20a8a7..8503cddd 100644
--- a/spec/Channel_Type_Contact_Search1.xml
+++ b/spec/Channel_Type_Contact_Search1.xml
@@ -26,7 +26,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       rather than handles; consequently, the values need not include
       <tt>x-telepathy-identifier</tt>.
     </tp:added>
-    <tp:changed version="UNRELEASED">
+    <tp:changed version="0.99.1">
       The requestable channel class now fixes TargetHandleType=NONE.
     </tp:changed>
 
diff --git a/spec/Channel_Type_Text.xml b/spec/Channel_Type_Text.xml
index b50beb80..b848bf09 100644
--- a/spec/Channel_Type_Text.xml
+++ b/spec/Channel_Type_Text.xml
@@ -27,7 +27,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       namespace='imt1.Channel.Interface'>Subject1</tp:dbus-ref> and
       <tp:dbus-ref namespace='imt1.Channel.Interface'>RoomConfig1</tp:dbus-ref>
       interfaces.</tp:changed>
-    <tp:changed version="UNRELEASED">Deprecated methods and types have
+    <tp:changed version="0.99.1">Deprecated methods and types have
       removed from this interface. Additionally, this interface has
       been merged with the old, now-removed, Messages interface as it
       was a requirement since version 0.21.5.</tp:changed>
diff --git a/spec/Connection.xml b/spec/Connection.xml
index 4347776c..f21059b0 100644
--- a/spec/Connection.xml
+++ b/spec/Connection.xml
@@ -81,9 +81,6 @@ USA.</p>
         is not yet in the CONNECTED state, this signal is not guaranteed
         to be emitted.
       </tp:docstring>
-      <tp:added version="0.UNRELEASED">Clients MAY assume that if the
-        SelfHandle and SelfID property exists, this signal will be emitted when
-        necessary.</tp:added>
 
       <arg type="u" tp:type="Contact_Handle" name="Self_Handle">
         <tp:docstring>
@@ -120,7 +117,7 @@ USA.</p>
         If the connection is not yet in the CONNECTED state, the value of
         this property MAY be empty string.
       </tp:docstring>
-      <tp:added version="0.UNRELEASED"/>
+      <tp:added version="0.99.1"/>
     </property>
 
     <property name="Status" tp:name-for-bindings="Status"
@@ -743,7 +740,7 @@ USA.</p>
       are now mandatory. Their functionality will be merged into the main
       Connection interface at some point in future.</tp:changed>
 
-    <tp:changed version="UNRELEASED">All deprecated types, methods,
+    <tp:changed version="0.99.1">All deprecated types, methods,
       and signals have been removed from this interface including
       anything to do with handle reference counting.</tp:changed>
 
diff --git a/spec/Connection_Interface_Aliasing1.xml b/spec/Connection_Interface_Aliasing1.xml
index a5614acd..55b11dca 100644
--- a/spec/Connection_Interface_Aliasing1.xml
+++ b/spec/Connection_Interface_Aliasing1.xml
@@ -59,7 +59,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <property name="AliasFlags"
       tp:name-for-bindings="Alias_Flags" type="u" access="read"
       tp:immutable="yes">
-      <tp:added version="0.UNRELEASED"/>
+      <tp:added version="0.99.1"/>
       <tp:docstring>
         A bitwise OR of flags from ConnectionAliasFlags detailing the behaviour
         of aliases on this connection.
diff --git a/spec/Connection_Interface_Avatars1.xml b/spec/Connection_Interface_Avatars1.xml
index e2040984..1d3f4626 100644
--- a/spec/Connection_Interface_Avatars1.xml
+++ b/spec/Connection_Interface_Avatars1.xml
@@ -20,7 +20,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
   </tp:license>
   <interface name="im.telepathy1.Connection.Interface.Avatars1">
     <tp:requires interface="im.telepathy1.Connection"/>
-    <tp:changed version="UNRELEASED">The deprecated method,
+    <tp:changed version="0.99.1">The deprecated method,
       GetAvatarRequirements, has been removed in favour of using the
       D-Bus properties instead.</tp:changed>
 
diff --git a/spec/Connection_Interface_Contact_List1.xml b/spec/Connection_Interface_Contact_List1.xml
index 2c0cbf97..a1ff6802 100644
--- a/spec/Connection_Interface_Contact_List1.xml
+++ b/spec/Connection_Interface_Contact_List1.xml
@@ -21,7 +21,7 @@
   <interface name="im.telepathy1.Connection.Interface.ContactList1">
     <tp:requires interface="im.telepathy1.Connection"/>
     <tp:added version="0.21.0">(as stable API)</tp:added>
-    <tp:changed version="UNRELEASED">The deprecated ContactsChanged
+    <tp:changed version="0.99.1">The deprecated ContactsChanged
       signal has been replaced with the ContactsChangedWithID
       version.</tp:changed>
 
diff --git a/spec/Connection_Interface_Requests.xml b/spec/Connection_Interface_Requests.xml
index 1d825d95..8707630b 100644
--- a/spec/Connection_Interface_Requests.xml
+++ b/spec/Connection_Interface_Requests.xml
@@ -374,7 +374,7 @@
       <tp:added version="0.17.11">(as stable API)</tp:added>
       <tp:changed version="0.17.14">Added a guarantee of ordering
         relative to the old NewChannel signal (now removed)</tp:changed>
-      <tp:changed version="0.UNRELEASED">Added recommendation against
+      <tp:changed version="0.27.1">Added recommendation against
         announcing channels together</tp:changed>
 
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
diff --git a/spec/Connection_Interface_Sidecars1.xml b/spec/Connection_Interface_Sidecars1.xml
index 08fe37da..3ab8b27d 100644
--- a/spec/Connection_Interface_Sidecars1.xml
+++ b/spec/Connection_Interface_Sidecars1.xml
@@ -22,7 +22,7 @@
 
   <interface name="im.telepathy1.Connection.Interface.Sidecars1">
     <tp:requires interface="im.telepathy1.Connection"/>
-    <tp:added version="0.UNRELEASED">from Connection.FUTURE</tp:added>
+    <tp:added version="0.99.1">from Connection.FUTURE</tp:added>
 
     <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
       <p>A <a href="http://en.wikipedia.org/wiki/Sidecar">sidecar</a>
diff --git a/spec/Connection_Manager.xml b/spec/Connection_Manager.xml
index 090908a3..37c0c9f6 100644
--- a/spec/Connection_Manager.xml
+++ b/spec/Connection_Manager.xml
@@ -103,7 +103,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
       </tp:docstring>
       <tp:changed version="0.17.1">Prior to version 0.17.1, the allowed
         characters were not specified</tp:changed>
-      <tp:changed version="UNRELEASED">
+      <tp:changed version="0.99.1">
         In Telepathy 0.x, protocol names could contain hyphen/minus signs,
         but not underscores.
       </tp:changed>
@@ -589,7 +589,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
     <tp:changed version="0.25.2">Prior to version 0.25.2 the
       serialization of object-path arrays (signature 'ao') was not
       defined</tp:changed>
-    <tp:changed version="0.UNRELEASED">GetParameters and ListProtocols
+    <tp:changed version="0.99.1">GetParameters and ListProtocols
       have been removed in favour of the
       <tp:member-ref>Protocols</tp:member-ref> property.</tp:changed>
   </interface>
diff --git a/spec/all.xml b/spec/all.xml
index dbca3376..7b3526c0 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>