Re: Developer API docs

2015-10-21 Thread Tal Liron
Thank you for your reply, Sundar. Unfortunately, your suggestions are insufficient. In the BSON translator, I do not have access to the script engine at all. It might not even be created: after all, the BSON translator can be invoked by Nashorn directly, not in JSR-223 mode. Likewise, you ha

Re: Developer API docs

2015-10-15 Thread Sundararajan Athijegannathan
Hi Tal Liron, Sorry about missing reply for this email. I somehow remember replying similar nashorn internal usage email. It is difficult maintain all of jdk.nashorn.internal.* between versions. Also, with security manager around, jdk.nashorn.internal.* are not accessible without explicit 'pac

Re: Developer API docs

2015-10-15 Thread Tal Liron
Hey guys, nobody ever responded to my message... Do you really think that my usage of these internal Nashorn APIs is so unwarranted? I tried to prove that some useful libraries need to use Nashorn APIs that some of you insist should not be made public. On 07/06/2015 09:10 PM, Tal Liron wrot

Re: Developer API docs

2015-07-06 Thread Tal Liron
Hi Atilla (and Sundar and everyone else, really), You asked which Nashorn APIs I'm using that are not documented. I will reply in full detail. For the BSON/JSON codecs, the most important thing is to access the NativeBoolean, NativeNumber, NativeArray, ConsString, Undefined, etc., classes. T

Re: Developer API docs

2015-07-06 Thread Attila Szegedi
The internal API is indeed documented in source, that’s just a good practice for future code comprehension and maintenance. But those APIs are not intended to be relied upon externally, as we don’t want to burden ourselves with backwards compatibility requirements over them. Lots of methods are

Re: Developer API docs

2015-07-05 Thread Tal Liron
Sundar, The JDK9 page is not loading for me. I am talking about JavaDocs: documentation for the Java API. Lots of the internal API is documented in source, but it's not generated and hosted publicly anywhere right now. I don't mean private classes: there is a wide range of public classes that

Re: Developer API docs

2015-07-05 Thread A. Sundararajan
Hi, https://docs.oracle.com/javase/8/docs/jdk/api/nashorn/ Actually, those are the only committed "official" APIs. For jdk9, jdk.nashorn.api.tree.* is added. http://download.java.net/jdk9/docs/jdk/api/nashorn/ Anything else is considered 'internal' implementation detail - and so subject to

Developer API docs

2015-07-04 Thread Tal Liron
Hi Nashorn, The only available JavaDocs I found are those for approved public consumption: https://docs.oracle.com/javase/8/docs/jdk/api/nashorn/ But, as you know, quite a few projects need to dig deeper into Nashorn plumbing. Would you consider publishing latest-official-release versions o