Scaladoc when hovering on members of unmanaged jar with javadoc

[ddemange]

Is your feature request related to a problem? Please describe.

I am working with unmanaged jars that :

• don't provide sources
• provide only classes and javadocs (compiled from scala 3)
• cannot be published on a repo, even locally

hovering on members of the jar only shows their types, and not their scaladoc.

The scaladoc only shows partially with autocompletion, when starting to type the name of a member (method), and it only shows for parameters.

Describe the solution you'd like

Hovering on any member provided by such a jar would show the complete scaladoc, like it does for members for which one has the source at hand. E.g. :

Describe alternatives you've considered

I am not aware of any alternative that would suit my use-case (apart from using a different IDE) :

• I cannot get the sources of the jars (third-party library)
• I cannot publish the jar files, even locally

Additional context

• scala 3.3.1
• scala Metals v1.29.0
• sbt 1.9.2
• vscode Version : 1.87.2 (Universal), Electron : 27.3.2

Search terms

scaladoc, hover, unmanagedJars

[tgodzik]

Thanks for reporting! If anyone picks it up it's worth to ask the compiler team to see if maybe there is a good way to do that.

[tgodzik]

Ok, so we should be able to fallback to the compiler, I did a small PoC but don't have time to confirm it.

https://github.com/scalameta/metals/compare/main...tgodzik:metals:fallback-comments?expand=1

@ddemange if you want you can try and publish locally to see if this helps for hover (we would need a small refactor to use the fallback everywhere). To do that you need:

sbt publishLocal
sbt ++3.3.1 mtagsShared/publishLocal mtags/publishLocal

then change the metals.serverVersion for you workspace.