W3C home > Mailing lists > Public > public-script-coord@w3.org > July to September 2011

Re: [WebIDL] add text to discourage `[Optional] Interface / [NoInterfaceObject] interface Interface` and encourage `dictionary Dictionary` instead

From: Cameron McCormack <cam@mcc.id.au>
Date: Thu, 01 Sep 2011 17:38:26 +1200
Message-ID: <4E5F1A52.4020808@mcc.id.au>
To: timeless <timeless@gmail.com>
CC: public-script-coord@w3.org
On 30/08/11 5:06 AM, timeless wrote:
> I recently saw a snippet of Web IDL code that goes like this:
>    function A(Foo foo, [Optional] Bar bar);
>
>    [NoInterfaceObject] interface Bar
>      { ... };
>
> In response to this, I'd like Web IDL to include some text to the effect of:
>
>      You SHOULD use `dictionary Foo` instead of `[NoInterfaceObject]
> interface Foo` if Foo is intended for use as an argument, especially
> an [Optional] argument.

I think [Optional] is not relevant here.  I've made the following change:

http://dev.w3.org/cvsweb/2006/webapi/WebIDL/Overview.html.diff?r1=1.369;r2=1.370;f=h

Please indicate whether this change is satisfactory.

Thanks,

Cameron
Received on Thursday, 1 September 2011 05:39:06 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:30:04 UTC