[Telepathy] ANNOUNCE: telepathy-spec 0.17.2

Simon McVittie simon.mcvittie at collabora.co.uk
Thu Mar 6 06:56:31 PST 2008


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

I've just tagged telepathy-spec 0.17.2. 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.2.tar.gz
sig: http://telepathy.freedesktop.org/releases/telepathy-spec/telepathy-spec-0.17.2.tar.gz.asc

Significant API changes:

* Alter usage of StreamedMedia channels to not abuse Group semantics,
  and allow better call state signalling - RequestStreams is now allowed on
  contacts not in the channel, and will add them to remote-pending state
  when an attempt has been made to contact them
* Explicitly say that clients must support CMs with no .manager file
  (telepathy-glib implements the required semantics, libtelepathy does not)
* Explicitly specify that IANA service names are valid and recommended
  for stream-tube service names (with dns-sd.org as a secondary source)
* Some avatar-related clarifications

New APIs:

* Add Account, AccountManager interfaces (a D-Bus API for the account
  management functionality in Mission Control)
* Add CallState interface (SIP 180 Ringing, 182 Queued, etc., or equivalent)
* Add Conn_Mgr_Param_Flag_Secret, a generic way to indicate passwords etc.
  in connection manager parameters

Tools changes:

* Support <tp:rationale> in docstrings
* Support D-Bus core Properties

Full changes below.

Regards,
    Simon

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

Thu Mar  6 14:39:59 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Prepare spec release 0.17.2

Thu Mar  6 13:00:59 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Fix conflict: whitespace vs addition of Media_Session_Type, Media_Session_Handler_Info

Wed Feb  6 16:34:58 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Interface_Media_Signalling: add some blank lines for clarity

Thu Mar  6 12:58:32 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Unconflict addition of some blank lines ot Channel_Type_Streamed_Media

Tue Feb 26 14:36:56 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Streamed_Media: add whitespace between signal, method, etc. elements

Tue Feb 26 14:34:43 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Text: wrap long lines

Mon Feb 25 13:49:10 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel: introduce some whitespace for clarity

Mon Feb 25 13:48:20 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection: introduce some whitespace for clarity

Thu Mar  6 12:55:37 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Streamed_Media: we like the whitespace

Wed Mar  5 17:47:27 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * doc-generator.xsl: generate docs for all interfaces at any level of nesting

Wed Feb 27 16:01:42 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add Channel_Call_State_Queued

Thu Mar  6 12:08:04 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Update NEWS for planned release

Thu Feb 28 11:43:32 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Connection_Interface_Privacy: set xmlns so HTML renders properly

Sun Feb 24 18:42:54 GMT 2008  tobias.hunger at basyskom.de
  * Add value-prefix to flag set where it was missing.

Sun Feb 24 18:49:39 GMT 2008  tobias.hunger at basyskom.de
  * fix array-name attributes.

Mon Feb 18 14:06:01 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * No longer reference the PresetParameters property, which no longer exists

Mon Feb 18 14:00:31 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Fix mismatched element

Mon Feb 18 14:00:05 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Improve comment with missing functionality

Fri Feb 15 12:47:49 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Drop PresetParameters, which turns out to be more contentious than I'd imagined (it interacts badly with mardy's plans for dynamic provisioning, see the mailing list)

Thu Feb 14 14:40:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Explain how RequestedPresence and AutomaticPresence interact

Thu Feb 14 14:37:00 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add Account_Presence type, and use it. Replace Account.RequestPresence method with Account.RequestedPresence r/w property.

Thu Feb  7 18:34:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add rationale for valid/invalid accounts

Thu Feb  7 18:31:27 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate AccountManager with missing functionality relative to NMC 4.x

Thu Feb  7 18:31:15 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add rationale to Account.ConnectionStatusReason

Thu Feb  7 18:30:56 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Remove unconventional underscores from Account.ConnectionStatus, Account.ConnectionStatusReason

Thu Feb  7 18:30:27 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add rationale to ConnectionStatus

Thu Feb  7 18:29:53 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Split desired presence into automatic presence and requested presence

Thu Feb  7 18:29:26 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Specify that UpdateParameters should not cause automatic reconnection (at least until someone persuades me otherwise)

Thu Feb  7 18:29:19 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Parameters with more rationale

Thu Feb  7 18:29:11 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Avatar with more rationale

Thu Feb  7 18:29:01 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Nickname with more rationale

Thu Feb  7 18:28:56 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Valid with rationale

Thu Feb  7 18:28:50 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Icon with rationale

Thu Feb  7 18:28:43 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate DisplayName with rationale

Thu Feb  7 18:28:33 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Removed with rationale

Thu Feb  7 18:28:13 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate Account with missing functionality

Thu Feb  7 16:54:07 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Oops, Connection should have been of type 's', not '(suu)'

Thu Feb  7 15:36:23 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add AccountManager, Account to the build

Thu Feb  7 15:36:15 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add a first draft of AccountManager

Thu Feb  7 15:36:07 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add a first draft of Account

Tue Jan 29 14:54:23 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add a Connection_Manager_Name type for easier referencing (it's not actually used in the API)

Mon Feb 18 19:13:09 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Remove redundant paragraph about failure behaviour - it was only applicable to an earlier attempt at the semantics

Mon Feb 18 19:12:32 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Document Channel_Call_State_Flags

Mon Feb 18 19:12:14 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Explicitly say that the call state need not ever be signalled

Mon Feb 18 18:44:07 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add Call State interface, and change the semantics of requesting streams with a non-pending member of StreamedMedia so we make them remote-pending as soon as we've tried to contact them

Fri Jan  4 20:24:50 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Explain in Channel_Type_Streamed_Media docstring what the new group semantics are

Fri Jan  4 20:24:30 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Fix malformed XML in Channel_Type_Streamed_Media

Fri Jan  4 20:07:01 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * StreamedMedia: allow RequestStreams on contacts not in the channel, so we can add them to remote-pending later, to signal e.g. that their phone is ringing

Wed Feb 20 15:47:12 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Document Property_ID

Wed Feb 20 15:47:04 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Annotate return from OfferStreamTube as a Tube_ID

Wed Feb 20 15:45:49 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Type_Tubes: annotate return from OfferDBusTube as a Tube_ID

Wed Feb 20 15:44:47 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Channel_Interface_Media_Signalling: fix namespacing (add Media prefix, change Session_Handler_Type to Session_Type because it's a property of the session); fix arity of return from GetSessionHandlers (add [])

Wed Feb 20 15:22:45 GMT 2008  tobias.hunger at basyskom.de
  * Introduce Session_Handler_Type.
  
  Introduce Session_Handler_Type into channel_interface_media_signaling as
  suggested by smcv.
  

Wed Feb 20 14:53:34 GMT 2008  tobias.hunger at basyskom.de
  * s/Search_Details/Search_Key_Info/g
  
  Rename the Search_Details* types to Search_Key_Info* as suggested by smcv.
  

Tue Feb 19 11:53:39 GMT 2008  tobias.hunger at basyskom.de
  * more-spec-types
  
  Add some tp:types tags. Add some types to use in the tp:types tags.
  

Tue Feb 19 10:27:22 GMT 2008  Sjoerd Simons <sjoerd at luon.net>
  * If you can't get the tokens without retrieving the avatar, then a correct implementation is to return a random token. So remove this case from the GetKnownAvatars exception

Tue Feb 19 10:02:46 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Explicitly say that service names for TCP tubes should be either an IANA service name from assignments/port-numbers or a dns-sd.org service type, rather than only referencing dns-sd.org (which itself references the IANA list)

Tue Feb 12 10:04:20 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Copyright 2008

Tue Feb 12 10:00:28 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * test: update expected output

Tue Feb 12 10:00:14 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * test: add a test case for D-Bus core Properties

Tue Feb 12 09:59:52 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * doc-generator.xsl: fix xmlns of rationales 

Tue Feb 12 09:58:44 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * devhelp.xsl: correctly index all types (except external-type) and simplify

Thu Feb  7 15:35:38 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * doc-generator: update CSS for properties and rationale

Thu Feb  7 15:35:12 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * doc-generator: support D-Bus core Properties

Thu Feb  7 15:34:52 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * doc-generator.xsl: support a <tp:rationale> element

Thu Feb  7 15:34:45 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * devhelp.xsl: whitespace

Thu Feb  7 15:34:26 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * devhelp.xsl: construct correct links when indexing types

Thu Feb  7 15:34:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * devhelp.xsl: index simple-type, mapping, flags as well as enums

Thu Feb  7 15:33:39 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * devhelp.xsl: emit D-Bus core Properties

Thu Feb  7 15:31:42 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Makefile: assume that all XML files starting with a capital letter are interfaces, and all starting with lower-case are misc.
  Based on a mail from Will Stephenson.

Wed Feb  6 16:41:38 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Remove extensibility mechanism - we don't really need it and it causes confusing warnings

Wed Feb  6 16:39:30 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Fix mismatched tag

Tue Jan 29 14:51:59 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Don't allow RequestHold to raise InvalidHandle (it doesn't take a handle argument any more). Clarify what NotAvailable means for it.

Thu Jan 24 12:46:44 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Relax mention of special handling of CM params containing "password" from a "should" to a backwards compatibility note

Thu Jan 24 11:59:10 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Explicitly say that clients must support CMs with no .manager file

Thu Jan 24 11:58:37 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Add Conn_Mgr_Param_Flag_Secret

Fri Jan 18 16:46:58 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * AvatarUpdated: recommend RequestAvatars, not the deprecated RequestAvatar

Thu Jan 17 17:24:08 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  * Development version 0.17.1.1

Thu Jan 17 17:23:05 GMT 2008  Simon McVittie <simon.mcvittie at collabora.co.uk>
  tagged telepathy-spec 0.17.1
-----BEGIN PGP SIGNATURE-----

iD8DBQFH0AYfWSc8zVUw7HYRAmgqAJsGm/yTVwhcdEIg9xh9JOrbrmmkrACbBUgb
/qDROhGv90hUUeqUc9zMthY=
=FS8B
-----END PGP SIGNATURE-----


More information about the Telepathy mailing list