W3C home > Mailing lists > Public > spec-prod@w3.org > October to December 2012

Re: ReSpec IDL: how to add comments inside an IDL block, and specify that "Class1 implements Class2" outside the block

From: Robin Berjon <robin@w3.org>
Date: Mon, 03 Dec 2012 17:41:44 +0100
Message-ID: <50BCD648.5000800@w3.org>
To: James Craig <jcraig@apple.com>
CC: "spec-prod@w3.org" <spec-prod@w3.org>
On 03/12/2012 17:29 , James Craig wrote:
> I've read the ReSpec.js docs and examples, and it mentions that some
> aspects of WebIDL are supported in ReSpec, but it's not clear to me
> which are not, or how to include some aspects, specifically these two:
>
> interface Foo {
> 	// 1. comments inside an IDL interface block
> };
> // 2. and any additional lines outside of an interface block such as:
> Foo implements Bar;
>

Neither is supported, and neither will ever likely be with the current 
IDL setup (the module for which is called webidl-oldschool for a reason).

By popular demand, I'm considering adding a *completely* new mode of 
entering IDL. It will involve just typing WebIDL and using hot comments 
to generate the description (which will also be less verbose). Comments 
that aren't hot comments will just get copied to the output.

I haven't started coding on the ReSpec part of this, but I've made the 
WebIDL parser that it'd use (which is to say that the hardest part is 
done). I haven't started drafting what the syntax would look like yet, 
so this is a very good time to express wishes :)

 > I will file bugs for these issues if I don't hear back within the week.

Don't hesitate to file bug anyway to track things!

-- 
Robin Berjon - http://berjon.com/ - @robinberjon
Received on Monday, 3 December 2012 16:41:57 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 3 December 2012 16:41:57 GMT