[Telepathy] [Bug 18219] New: RequestConnection' s well-known key list and argument documentation is unclear

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=18219

           Summary: RequestConnection's well-known key list and argument
                    documentation is unclear
           Product: Telepathy
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: telepathy-spec
        AssignedTo: telepathy at lists.freedesktop.org
        ReportedBy: will.thompson at collabora.co.uk


RequestConnection's list of well-known connection parameters[0] lists a string
key named "foo" as "s:foo", which does not make it clear that "s:" is not part
of the key. It would be better if they looked more like the documentation of
MessageParts' keys[1].

The Parameters parameter (!) being described as "A dictionary mapping parameter
name to the variant boxed value" is also kind of cryptic.

[0]
http://telepathy.freedesktop.org/spec.html#org.freedesktop.Telepathy.ConnectionManager
[1]
http://telepathy.freedesktop.org/spec.html#org.freedesktop.Telepathy.Channel.Interface.Messages.DRAFT.Message_Part


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.