Subj : Re: JS_NewNumberValue(), JSIdArray; documentation To : netscape.public.mozilla.jseng From : Matthew Mondor Date : Thu Aug 25 2005 01:52 am On Tue, 23 Aug 2005 21:06:39 -0700 Brendan Eich wrote: > > 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. Okay I didn't deprecate them and I removed the comments about "internal use only", as well a added information on how to interpret the fields of the JSIdArray structure into its manual page then. What is currently flagged as deprecated should probably eventually be revised, though, I'll just leave them as-is for now however, since a proper authority should do that. > Thanks for doing this work, I love SpiderMonkey, and it's one of the few things I can do in an attempt to support it and allow more people to easily use it, so it's worth spending some time on... I in turn thank the devmo people who put the efforts in setting up MediaWiki to allow this Matt -- Note: Please only reply on the list, other mail is blocked by default. Private messages from your address can be allowed by first asking. .