highlight method needs clarification

[...PROLOG...the links [2], [3] are OASIS member only...apologies...there 
is some bizarre problem with the WebCGM TC archives at OASIS, wherein the 
public access route seems broken...rather than await the fix, I think we 
should get this AI of mine into the WG queue...I will resend with public 
links when they are fixed...]

PROBLEM:  The description of the highlight method on the Picture interface 
[1] needs clarification.

[1] http://www.w3.org/TR/2006/WD-webcgm20-20060623/WebCGM20-DOM.html#L5070

BACKGROUND:  When the WebCGM TC was developing the Picture-highlight test 
(which is on FTP but not yet in the distribution), at least two people 
misunderstood the nature of using highlight to turn on highlighting on a 
node.  In particular, they incorrectly assumed it behaved like a Style 
Property (SP), and would exhibit the CSS-borrowed inheritance model that 
applies to SPs.  It does not.

This was discussed in the CGMO WebCGM TC and a consensus was reached [2], 
[3].  That clarification needs to be included in the descriptive text of 
the highlight method, because the behavior is not obvious (especially as 
regards inheritance or not).  An example would help here also.

[2] 
http://www.oasis-open.org/apps/org/workgroup/cgmo-webcgm/email/archives/200605/msg00101.html
[3] 
http://www.oasis-open.org/apps/org/workgroup/cgmo-webcgm/email/archives/200607/msg00010.html

OTHER highlight() comments:

-- a mention of and link to the toNodeList utility method would be nice;
-- s/a IRI/an IRI/

Regards,
-Lofton.

Received on Tuesday, 1 August 2006 23:57:40 UTC