[Telepathy-commits] merge: telepathy-spec

[Merge Monkey]

Merge to:

  telepathy-spec

From:

  /home/smcv/public_html/darcs/tp-spec-smcv-requestotron

Changes:

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add .DRAFT to Requests namespace

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Explain the semantics of RequestChannels raising NotAvailable

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: remove unnecessary wording which has moved to the definition of TargetHandle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add Requests interface to HTML spec

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add type annotation to Properties member of Channel_Details

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add a sketch of the Requests interface

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TargetHandle: explain exactly what this means in a request

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add TargetID to Channel interface, now that we've proved that the implementation is easy

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel_Request_Flags: add missing type 'u'

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Rethink the RequestableChannelClasses property based on discussion yesterday

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: explicitly allow RequestChannels(... StreamedMedia, CONTACT, fred, ...) to return an anonymous channel with Fred in its members

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: add AvailableChannelClasses property

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add Required_Properties and Interfaces to Channel_Class

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.ChannelType: is always required in requests, and must always be satisfied

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel_Details: correct type of Properties

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.Interfaces: strengthen requirement about request behaviour to a MUST

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.Future: remove TargetID, it's now in the core

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: merge Required_Properties and Optional_Properties into Allowed_Properties

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Correct comment

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Rename AvailableChannelClasses to RequestableChannelClasses and make its type more elaborate, to be able to express restrictions on properties

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    NewChannels: remove Flags for a more minimal design - I'll see how far we can get without them

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Properties in Allowed_Properties may either be required or optional, but it's may[en], not MAY[en_RFC]

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Merge addition of Conn.I.Requests and ChannelBundle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    RequestChannels: remove Flags output parameter out of a general feeling of YAGNI - I'll see how far we can get without it

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.TargetHandle, Channel.TargetHandleType: reference Channel.TargetID

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add Channel_Request_Response

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.FUTURE: Requested: fix cross-reference to Requests

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Explain that properties in a channel request could (and probably will) be read-only after the channel has been created

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Clarify that InitiatorHandle, InitiatorID MUST NOT be passed to requests

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: use proper "added" annotation

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: rename Namespaced_Property_Value_Map to Qualified_Property_Value_Map

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Channel.FUTURE: add Requested property

This is another attempt to resolve the incoming/outgoing problem, with
more predictable semantics. Having deprecated suppress_handler=FALSE in
requests, I'm now allowing clients to assume that in pre-Requests CMs,
channels announced with suppress_handler=FALSE are unrequested.

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: remove Channel_Announcement_Flags entirely

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Explain TargetID's effect on requests

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Remove reference to InitiatorID in TargetID

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: hyperlink Bundle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: re-indent license since this is a new file anyway

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    In Channel_Details, hyperlink to TargetHandle etc. and add rationale

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Conn.I.Requests: TargetID is mandatory too

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    In NewChannel, mention that suppress_handler=FALSE is deprecated for outgoing channels

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Replace RequestChannels with CreateChannel; remove EnsureChannel while we decide whether we actually need it

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Change ChannelsClosed signal to ChannelClosed

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Explain the semantics of RequestChannels raising NotImplemented

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Clients MAY assume that if a channel has suppress_handler=true, it was requested. The converse is not necessarily true

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Connection managers MUST NOT create "side-effect" channels if they can help it

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add a FIXME note to Requests with some other properties that should perhaps be required in Channel_Details

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add a FIXME note: perhaps Channel_Announcement_Flag_Reused is unnecessary?

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Mark Requests as experimental

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    TargetHandleType: if omitted from a request, it's Handle_Type_None

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Explain the semantics of RequestChannels raising InvalidHandle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Document RequestChannels

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: in Channel_Announcement_Flags, remove Suppress_Handler (we're basically mapping this to the Requested property now).

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Make RequestChannels return an array of Channel_Request_Response rather than an array of Channel_Details

This adds the "reused" flag on a per-channel basis, which turns out to be
necessary - when channels are requested, the channel dispatcher must ensure
that exactly those channels that were not reused are sent to a handler.

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: remove reuse flags in favour of a separate EnsureChannels method

As per discussion yesterday and lots of scribbling on a whiteboard, we think
this makes the API clearer.

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Add Channel_Request_Response_Flags

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: don't allow requests with Suppress_Handler=false at all

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    The type of Channel_Class::Properties is DBus_Qualified_Member, not DBus_Member

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Indicate semantics of passing Interfaces to RequestChannels

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Re-indent

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Require Channel_Details to contain ChannelType, TargetHadleType and TargetHandle

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Requests: better docstring for RequestChannels

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Decide that CMs shouldn't have more than one channel-class with the same channel type/handle type

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    Remove obsolete Property_Restriction_Map type

  Simon McVittie <simon.mcvittie at collabora.co.uk>
    NewChannels MUST be signalled before CreateChannel returns