Subj : Re: Finding APIs
To   : Sterling Bates
From : Brendan Eich
Date : Thu Apr 22 2004 02:47 pm

Sterling Bates wrote:
> A couple things:
> 
> 1. What is the most efficient way to search for APIs?  Would I use 
> http://lxr.mozilla.org/mozilla/ident?i=JS_PUBLIC_API ?


That's fine, but it doesn't distinguish between jsdbgapi.h, jsxdrapi.h 
and jsapi.h.  The last is most frozen (although JSObjectOps is not). 
The debugger API is fairly frozen, I would say, but it has fewer 
consumers and less time in the field being pounded to low temperature. 
The XDR API is just too new and little-used outside of Mozilla, AFAIK, 
to be promoted yet.

So let's stick with documenting jsapi.h (and therefore jspubtd.h, except 
for the JSObjectOps-only types).


> 
> 2. Which structures do we document?  I looked at JSObject this morning, 
> but I'm not sure that's a public type.
> 


The struct is declared in jsobj.h, so of course it is not public or 
frozen. But the typedef name is in jspubtd.h and therefore, as the 8.3 
cryptic-filename (ah, Windows 3.1 memories!) suggests, "pub"lic.

/be

.