Bug 17148

Summary: [tools] Needs markup for requestability
Product: Telepathy Reporter: Simon McVittie <smcv>
Component: tp-specAssignee: Telepathy bugs list <telepathy-bugs>
Status: RESOLVED FIXED QA Contact: Telepathy bugs list <telepathy-bugs>
Severity: normal    
Priority: medium    
Version: unspecified   
Hardware: Other   
OS: All   
Whiteboard:
i915 platform: i915 features:

Description Simon McVittie 2008-08-15 03:45:04 UTC 
telepathy-spec should have some markup that indicates that a property is useful in CreateChannel (and hypothetically, EnsureChannel) calls. Proposal (using TargetHandle as my example property):

<tp:requestable>
<p>If <a>TargetHandleType</a> is not Handle_Type_None, then either TargetHandle or <a>TargetID</a> must be given.</p>

<p>If <a>TargetHandleType</a> is omitted or Handle_Type_None, or <a>TargetID</a> is given, then TargetHandle must be omitted.</p>
</tp:requestable>

leading to output like:

<h3>Using this property in requests</h3>

This property can be used when requesting a channel.

<p>If <a>TargetHandleType</a> is not Handle_Type_None, then either TargetHandle or <a>TargetID</a> must be given.</p>

<p>If <a>TargetHandleType</a> is omitted or Handle_Type_None, or <a>TargetID</a> is given, then TargetHandle must be omitted.</p>
Comment 1 Simon McVittie 2010-11-09 05:44:32 UTC 
Will fixed this with attributes.

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.