Bug 42653 - Channel.I.Picture not considered stable
Summary: Channel.I.Picture not considered stable
Status: RESOLVED MOVED
Alias: None
Product: Telepathy
Classification: Unclassified
Component: tp-spec (show other bugs)
Version: git master
Hardware: Other All
: medium normal
Assignee: Telepathy bugs list
QA Contact: Telepathy bugs list
URL: http://cgit.collabora.com/git/user/da...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-11-06 21:37 UTC by Danielle Madeley
Modified: 2019-12-03 20:25 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments
RoomConfig.PasswordHint (2.59 KB, patch)
2011-11-06 22:45 UTC, Danielle Madeley
Details | Splinter Review
Room: Creator, CreatorHandle and CreationTimestamp (2.09 KB, patch)
2011-11-06 22:45 UTC, Danielle Madeley
Details | Splinter Review
New iface: Channel.Interface.Picture (9.25 KB, patch)
2011-11-06 22:45 UTC, Danielle Madeley
Details | Splinter Review
Document how no-data is represented in the Avatar type (1.06 KB, patch)
2011-11-07 02:08 UTC, Danielle Madeley
Details | Splinter Review

Description Danielle Madeley 2011-11-06 21:37:12 UTC
Including:
 - Picture
 - Creator (and Handle)
 - CreationTimestamp
 - PasswordHint

Separate to RoomConfig (I think) we also need an interface to define the capabilities of Room members and be able to set those, e.g. who can speak, what capabilities new member should get on joining, and how an operator can set those capabilities.
Comment 1 Danielle Madeley 2011-11-06 21:38:09 UTC
Also it's not very clear how long Description should be. e.g. a protocol which has an optional room property called Guidelines, could that be the Description?
Comment 2 Danielle Madeley 2011-11-06 22:45:33 UTC
http://cgit.collabora.com/git/user/danni/telepathy-spec.git/log/?h=roomconfig-42653

After thinking about it, I decided the Creator stuff was more closely related to the Chan.I.Room and Picture should be its own interface. I put PasswordHint on RoomConfig and a flag on Password indicating clients should check the hint.
Comment 3 Danielle Madeley 2011-11-06 22:45:46 UTC
Created attachment 53229 [details] [review]
RoomConfig.PasswordHint

A hint for the room password.

Fixes:
Comment 4 Danielle Madeley 2011-11-06 22:45:51 UTC
Created attachment 53230 [details] [review]
Room: Creator, CreatorHandle and CreationTimestamp

These properties indicate who and when the room was created.

Fixes:
Comment 5 Danielle Madeley 2011-11-06 22:45:57 UTC
Created attachment 53231 [details] [review]
New iface: Channel.Interface.Picture

Lets the users set/get the picture for a chatroom.

Fixes:
Comment 6 Will Thompson 2011-11-07 01:31:44 UTC
Comment on attachment 53229 [details] [review]
RoomConfig.PasswordHint

Review of attachment 53229 [details] [review]:
-----------------------------------------------------------------

Looks good.
Comment 7 Will Thompson 2011-11-07 01:32:29 UTC
Comment on attachment 53230 [details] [review]
Room: Creator, CreatorHandle and CreationTimestamp

Review of attachment 53230 [details] [review]:
-----------------------------------------------------------------

Looks good!
Comment 8 Will Thompson 2011-11-07 01:41:29 UTC
Comment on attachment 53231 [details] [review]
New iface: Channel.Interface.Picture

Review of attachment 53231 [details] [review]:
-----------------------------------------------------------------

Looks good, broadly speaking.

::: spec/Channel_Interface_Picture.xml
@@ +1,5 @@
> +<?xml version="1.0" ?>
> +<node name="/Channel_Interface_Picture"
> +  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
> +
> +  <tp:copyright>Copyright © 2010â2011 Collabora Ltd.</tp:copyright>

I wonder why this is mojibaked in my browser. Is Splinter insufficiently UTF-8 clean? :/

@@ +73,5 @@
> +      </tp:possible-errors>
> +    </method>
> +
> +    <property name="Picture" tp:name-for-bindings="Picture"
> +              type="(ays)" tp:type="Avatar" access="read">

Do we maybe want to annotate this with EmitsChangedSignal: invalidates?

@@ +75,5 @@
> +
> +    <property name="Picture" tp:name-for-bindings="Picture"
> +              type="(ays)" tp:type="Avatar" access="read">
> +      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
> +        <p>The picture representing this channel.</p>

This property doesn't define what “no picture” looks like (though it's pretty obvious, I guess). The Account.I.Avatar.Avatar property does; maybe move that definition to the struct definition and then we're done?
Comment 9 Danielle Madeley 2011-11-07 02:06:59 UTC
> I wonder why this is mojibaked in my browser. Is Splinter insufficiently UTF-8
> clean? :/

Hmm, I'd be tempted to blame git-bz munging the mime type perhaps?

> Do we maybe want to annotate this with EmitsChangedSignal: invalidates?

I think this causes a problem where multiple handlers/observers are watching the channel, and now all have to call Get(). It's not like this signal will fire frequently.

> This property doesn't define what “no picture” looks like (though it's pretty
> obvious, I guess). The Account.I.Avatar.Avatar property does; maybe move that
> definition to the struct definition and then we're done?

Done.
Comment 10 Danielle Madeley 2011-11-07 02:08:33 UTC
Created attachment 53235 [details] [review]
Document how no-data is represented in the Avatar type

Fixes:
Comment 11 Will Thompson 2011-11-07 03:28:15 UTC
Comment on attachment 53235 [details] [review]
Document how no-data is represented in the Avatar type

Review of attachment 53235 [details] [review]:
-----------------------------------------------------------------

++
Comment 12 Danielle Madeley 2011-11-07 03:32:36 UTC
Merged.
Comment 13 Simon McVittie 2013-11-04 17:41:14 UTC
Channel.I.Picture was never undrafted.

Do implementations (client- and service-side) exist? Are they any good?

(In other words: undraft or delete?)
Comment 14 Danielle Madeley 2013-11-19 03:30:27 UTC
I don't think I ever implemented it. There's only one protocol I know of that supports the feature.
Comment 15 Simon McVittie 2013-11-19 13:23:11 UTC
Thanks, I'll delete this from the Telepathy 1.0 branch at some point, and WONTFIX this. It can come back if it's ever actually implemented.
Comment 16 GitLab Migration User 2019-12-03 20:25:14 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/telepathy/telepathy-spec/issues/124.


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.