Subj : Re: JS_NewNumberValue(), JSIdArray; documentation
To   : Matthew Mondor
From : Brendan Eich
Date : Tue Aug 23 2005 10:06 pm

Matthew Mondor wrote:
> (especially to Brendan)
> 
> Working on the new SpiderMonkey documentation on the new wiki DevMo
> site, migrating docs from the old documentation...
> 
> Should JS_NewNumberValue() still have an "internal use only" text in the
> summary description?

Absolutely not!

> Also, how about the JSIdArray structure which has a similar note in its
> summary?  I personally had to use that structure once for C code which
> needed to iterate through both properties and array elements of an
> object so far...

Everything in jsapi.h is public API.  There should be no such "internal 
use only" notes in the docs.  Deprecated APIs may be described as such, 
although we should probably review the list to see if the loopy old docs 
deprecated too much.

Thanks for doing this work,

/be

.