Bug 37109

Summary: Change DelegateChannels
Product: Telepathy Reporter: Guillaume Desmottes <guillaume.desmottes>
Component: tp-specAssignee: Telepathy bugs list <telepathy-bugs>
Status: RESOLVED FIXED QA Contact: Telepathy bugs list <telepathy-bugs>
Severity: normal    
Priority: medium Keywords: patch
Version: unspecified   
Hardware: Other   
OS: All   
URL: http://cgit.collabora.co.uk/git/user/cassidy/telepathy-spec/log/?h=delegate-channels-37109
Whiteboard: review+
i915 platform: i915 features:
Bug Depends on:    
Bug Blocks: 33271, 34610    
Attachments: DelegateChannels: return the list channels of (not) delegated channels (fdo #37109)

Description Guillaume Desmottes 2011-05-11 05:28:52 UTC
As discussed on IRC, DelegateChannels() should return the list of channels which have been delegated and those which have not.
Comment 2 Jonny Lamb 2011-05-12 07:02:47 UTC
Not sure about some of the indentation around this change, but meh.

+ <p>This method returns once all the <var>Channels</var> have either be
+ accepted or rejected by Handlers.</p>

...have either been accepted...

+ <p>Client SHOULD remove those channels from their

The client should remove these channels from its

+ <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">HandledChannels</tp:dbus-ref>

use "ofdT" instead of "org.freedesktop.Telepathy"

You should add a tp:changed or whatever it is saying what version it changed in and what exactly changed.
Comment 3 Guillaume Desmottes 2011-05-13 00:49:46 UTC
(In reply to comment #2)
> + <p>This method returns once all the <var>Channels</var> have either be
> + accepted or rejected by Handlers.</p>
> 
> ...have either been accepted...

fixed.

> + <p>Client SHOULD remove those channels from their
> 
> The client should remove these channels from its

changed.

> + <tp:dbus-ref
> namespace="org.freedesktop.Telepathy.Client.Handler">HandledChannels</tp:dbus-ref>
> 
> use "ofdT" instead of "org.freedesktop.Telepathy"

done.

> You should add a tp:changed or whatever it is saying what version it changed in
> and what exactly changed.

I updated the branch and HTML.
Comment 4 Guillaume Desmottes 2011-05-13 00:50:00 UTC
Created attachment 46665 [details] [review]
DelegateChannels: return the list channels of (not) delegated channels (fdo #37109)
Comment 5 Jonny Lamb 2011-05-13 08:17:29 UTC
You need to change the tp:docstring for InvalidArgument for DelegateChannels as it no longer has an Account argument.

+ <tp:changed version="0.23.UNRELEASED">This methods now returns

*method

in the NotYours error tp:docstring:

    "The caller is not currently handling the channels. "

Can you clarify this please? Will it fail with NotYours if only one of the channels is not being handled by this handler? What will happen to the other channels?

Sorry I should have noticed those before.
Comment 6 Guillaume Desmottes 2011-05-15 23:23:27 UTC
(In reply to comment #5)
> You need to change the tp:docstring for InvalidArgument for DelegateChannels as
> it no longer has an Account argument.

removed.

> + <tp:changed version="0.23.UNRELEASED">This methods now returns
> 
> *method

fixed.

> in the NotYours error tp:docstring:
> 
>     "The caller is not currently handling the channels. "
> 
> Can you clarify this please? Will it fail with NotYours if only one of the
> channels is not being handled by this handler? What will happen to the other
> channels?

done.
Comment 7 Jonny Lamb 2011-05-16 00:20:35 UTC
Looks good.
Comment 8 Guillaume Desmottes 2011-05-16 00:28:06 UTC
Merged to master; will be in 0.23.2.

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.