Re: [WebIDL] Would it make sense to add annotations for "creates a new object each time" and "always returns the same object"? from Boris Zbarsky on 2013-07-23 (public-script-coord@w3.org from July to September 2013)

From: Boris Zbarsky <bzbarsky@MIT.EDU>
Date: Tue, 23 Jul 2013 01:53:35 -0400
To: Cameron McCormack <cam@mcc.id.au>
CC: Jonas Sicking <jonas@sicking.cc>, Ojan Vafai <ojan@chromium.org>, Glenn Adams <glenn@skynav.com>, "public-script-coord@w3.org" <public-script-coord@w3.org>
Message-ID: <51EE1A5F.7010406@mit.edu>

On 7/23/13 1:37 AM, Cameron McCormack wrote:
> I added [SameObject] (on attributes) and [NewObject] (on operations)
> extended attributes.  I chose not to go with [Creator], since that could
> be confused with the "creator" keyword.
>
> http://dev.w3.org/cvsweb/2006/webapi/WebIDL/Overview.xml.diff?r1=1.642;r2=1.643;f=h

Thanks!

The example for [NewObject] is wrong: getElementsByTagName is allowed to 
return an existing list.  I suggest using createElement as an example 
instead.

-Boris

Received on Tuesday, 23 July 2013 05:54:07 UTC