[Telepathy] ANNOUNCE: telepathy-spec 0.17.3

Thu Apr 3 09:24:59 PDT 2008

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I've just tagged telepathy-spec 0.17.3, the "please hold" release.

The latest release is, as always, available from:
http://telepathy.freedesktop.org/spec.html
http://darcs.collabora.co.uk/darcs/telepathy/telepathy-spec/

For the benefit of packagers (e.g. http://packages.debian.org/telepathy-spec):
tar: http://telepathy.freedesktop.org/releases/telepathy-spec/telepathy-spec-0.17.3.tar.gz
sig: http://telepathy.freedesktop.org/releases/telepathy-spec/telepathy-spec-0.17.3.tar.gz.asc

API changes:

* Change documented semantics of SendError to match what Gabble and Haze
  have always done: Send emits Sent when the message is submitted, or no
  signal on failure, and SendError is emitted *after* Sent if an error is
  detected later

* Explain that AcknowledgePendingMessages is where "message received"
  acknowledgements should be sent

* Some interfaces we've never actually implemented, which we do not believe
  are necessarily very well thought-out, have been removed from the HTML
  specification to reduce confusion:
  - ContactInfo (XML vCards over D-Bus... what were we thinking?)
  - ContactSearch (server-side searches like XEP-0055)
  - Forwarding (an incomplete implementation of call-forwarding in telephony)
  - Privacy (a much more complex version of the 'block' API)
  - Transfer (transferring contacts between calls in telephony)

* Whether other people have put us on hold is now signalled as a call state

* The scope of the Hold interface has been reduced; it now only manipulates
  whether we have put the call on hold, not whether other people have put
  us on hold (note that the Hold interface is still considered experimental,
  and it's likely to change in the next release)

API additions:

* Media.StreamHandler now has a SetStreamHeld signal to ask streaming clients
  (stream-engine) to release or acquire the necessary resources for media
  streaming, and HoldState and UnholdFailure methods so the streaming client
  can indicate success or failure; these can be used to implement the
  Hold interface

Deprecations:

* Passing clear=TRUE to ListPendingMessages (the client cannot guarantee that
  the messages will actually be shown to the user or logged, if this is done)

Tools changes:

* Allow arrays of mappings

* Allow rationale to be interleaved with HTML in docstrings

Full Darcs changes follow.

Regards,
    Simon

Thu Apr  3 17:02:27 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  tagged telepathy-spec 0.17.3

Thu Apr  3 16:58:35 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Adjust whitespace in expected `make check` output

Thu Apr  3 16:04:33 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Revert marking Hold as API-stable - it's not ready right now

Thu Apr  3 15:28:18 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Prepare for a 0.17.3 release

Thu Apr  3 15:28:10 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Update NEWS

Thu Apr  3 15:20:50 BST 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Mark Hold as stable

Thu Mar 20 16:26:44 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Say that contacts on hold do not receive media, not streams

Thu Mar 20 16:26:31 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Call_State_Held should be 4, this is a bitfield

Thu Mar 20 16:06:53 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * StreamHandler: rename UnholdFailed to UnholdFailure to be consistent with Error

Thu Mar 20 16:05:32 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Simplify the Hold interface by only having it manipulate whether we have put the channel on hold: whether others have put us on hold is now a call-state

Thu Mar 20 16:05:06 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Indicate whether other people have put us on hold as a call state

Wed Mar 19 13:50:04 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * StreamHandler: add SetStreamHeld, HoldState, UnholdFailure

Wed Mar 19 16:51:00 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Say Handle_Type_None instead of 0

Wed Mar 19 16:49:51 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection: tidy up wording of handle, handle type in NewChannel signal

Wed Mar 19 16:49:41 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection: re-wrap long line

Wed Mar 19 16:21:55 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Capabilities: add whitespace between children of <interface>

Wed Mar 19 16:02:20 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Capabilities: move docstring, Connection_Capability_Flags to the top (moving the latter inside the <interface> in the process). Rewrap the docstring

Wed Mar 19 17:09:26 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Update NEWS for merges of tp-spec-smcv-hold, tp-spec-smcv-unbonging

Tue Mar 18 14:56:23 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Remove never-implemented legacy interfaces from all.xml so they don't end up in the spec HTML

Tue Mar 18 16:06:28 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Update NEWS with merged changes so far in 0.17.3

Tue Mar 18 13:37:49 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Move Handle, Contact_Handle, etc. from generic-types to Connection (since that's their scope)

Tue Mar 18 13:36:16 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * ConnectionManager: annotate bus name returned from RequestChannel as a DBus_Bus_Name

Tue Mar 18 13:35:52 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * ConnectionManager: remove remnant of inline list of protocols in ListProtocols (it's now documented under Protocol)

Tue Mar 18 13:35:26 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * ConnectionManager: add some whitespace

Tue Mar 18 13:52:50 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Clarify interaction between ListPendingMessages(clear=true) and AcknowledgePendingMessages

Tue Mar 18 13:52:38 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Clarify exact meaning of AcknowledgePendingMessages

Mon Mar 17 17:32:07 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Deprecate clear=true argument to ListPendingMessages

Mon Mar 17 17:31:39 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Let AcknowledgePendingMessages raise NetworkError (in case it's actually sending acks on the network)

Mon Mar 17 17:31:11 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * In AcknowledgePendingMessages, mark up interpretation of InvalidArgument so it displays in the HTML

Mon Mar 17 17:28:09 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Clarify that AcknowledgePendingMessages is the way to send message acknowledgements, in protocols that can

Thu Mar 13 18:46:45 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Text: explain the Action message type better

Wed Mar 12 17:38:37 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Amend Text interface so Send emits Sent at the time that it returns, and SendError can only be emitted later.
  This directly contradicts the interface docstring in previous spec versions
  (up to 0.17.2), but agrees with what Gabble and Haze implement in practice.

Wed Mar 12 11:47:21 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Allow arrays of mappings

Wed Mar 12 11:47:01 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Allow rationale to be mixed in with HTML in docstrings

Wed Mar 12 11:20:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Text: clarify semantics of Send, Sent, SendError based on Rob's explanation

Tue Mar 18 13:28:22 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection.GetSelfHandle: annotate return type as Contact_Handle

Tue Mar 18 13:28:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection.GetProtocol: annotate return type as Protocol

Tue Mar 18 13:33:31 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection: remove some trailing whitespace

Wed Mar 12 11:27:05 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Remove unnecessary textual type annotations (now obsoleted by markup)

Wed Mar 12 11:26:30 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Pending_Text_Message::Unix_Timestamp as type Unix_Timestamp

Wed Mar 12 11:19:49 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Text: we like the whitespace

Mon Feb 25 19:08:30 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add some whitespace to Channel_Type_Contact_List

Thu Mar  6 14:51:47 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Bump nano version

Thu Mar  6 14:45:00 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  tagged telepathy-spec 0.17.2
-----BEGIN PGP SIGNATURE-----

iD8DBQFH9QTbWSc8zVUw7HYRApEQAJ46CnkX0jlBd1TrrjSQuiCBc3wrIQCgge5c
MXOTretkKinMLjyJXkkusbc=
=7tuj
-----END PGP SIGNATURE-----