SpencerPark / IJava

A Jupyter kernel for executing Java code.
MIT License
1.09k stars 212 forks source link

Compile javadocs to html for introspection #8

Open SpencerPark opened 6 years ago

SpencerPark commented 6 years ago

The introspection supports rendering richer data than just text and we should take advantage of that to render the javadocs as HTML.

SpencerPark commented 5 years ago

The openjdk implementation of the source code analysis actually makes no attempt to search for sources other than those in the installation's src.zip which is very unfortunate. Including the jshell's user code!

The source code analysis is really lacking in this department. One solution we can try is setting the private List<Path> availableSources; field which has been fairly stable for some time. It is only used in the documentation generation. Another option is to search javadoc jars which are added to the classpath and are usually resolved with maven dependencies. The analysis supports searching for QualifiedNames at a cursor which we could use to try and find the appropriate html page and simply show the entire thing?