Javadoc Syntax highlighting

[3ximus]

Not sure if i should ask this here, but would it be possible for you to add syntax highlighting for javadoc?

[fbricon]

Can you be more specific?

This is hovering over the String class:

[3ximus]

I meant custom javadoc like this:

as I have for example on eclipse or Gvim:

Also hovering over a class (String for example ) doesnt give me any javadoc popup like the one you showed...

[fbricon]

I see. And I agree that's a perfectly legitimate request.

You only get javadoc on hover when the java file is opened within a project directory (must be an Maven or Eclipse project), not as a standalone file.

[3ximus]

I do have a maven project open. Everything works, like completion and my custom javadoc is displayed, but not javadoc of classes or methods that I didnt define.
Dont know if it matters but I have java.home set to: "java.home": "/usr/lib/jvm/java-8-openjdk", and I'm running this on Arch Linux.

[fbricon]

While javadoc syntax highlighting is probably fixable in vscode-java, I believe this is something that should be fixed upstream, in https://github.com/Microsoft/vscode/blob/master/extensions/java/syntaxes/java.json. @gorkem WDYT?

[fbricon]

@3ximus I don't see why this behavior would be missing on linux, given the rest works. Can you try on another OS?

[3ximus]

Yeah. I've tried it on Kali Linux and it has the exact same problem. However on Windows 10 it works fine.

[gorkem]

@fbricon Syntax highlights are on the vanilla vscode, I think it is best to handle it in there. Opened microsoft/vscode#15527 let's see what vscode team responds.

[gorkem]

@3ximus Are you missing javadocs for 3rd party libraries or JDK classes?

[3ximus]

I haven't tried on any third party libraries, only on JDK classes

[gorkem]

You probably do not have the source files or javadocs for the JDK classes on your JVM installation. We extract javadocs from either sources or javadocs.

[3ximus]

Yes, you are right... My bad. Thanks, keep up the good work 😉

[fbricon]

Upstream got it almost working, except for closing tags. See microsoft/vscode#16041

[fbricon]

So microsoft/vscode#16041 has been fixed. Until VS Code 1.10 is released, you need to use the Insider build.

[fbricon]

VS Code 1.10 was released today, Javadoc looks good now.