Subj : Re: API docs
To   : Sterling Bates <whoelse@sterlingbates.com>
From : Brendan Eich <brendan@meer.net>
Date : Thu Apr 15 2004 08:34 pm

Sterling Bates wrote:
> Another problem is when a function (for instance, JS_NewRuntime) has 
> been #define'd to another name (JS_Init), and that redefined name 
> appears in the DLL manifest.  How would I display the alternate name in 
> the docs?  Perhaps just as a "see also"?


No, you should deprecate the old name (the function name), which was 
kept only for binary compatibility.  People should use the new name, 
which the macro defines.

/be

.