davidB / scala-maven-plugin

The scala-maven-plugin (previously maven-scala-plugin) is used for compiling/testing/running/documenting scala code in maven.
https://davidb.github.io/scala-maven-plugin/
The Unlicense
560 stars 151 forks source link

Replayed relevant changes from scaladoc3. #611

Open chr78rm opened 2 years ago

chr78rm commented 2 years ago

Fix for issue #604.

alexfoxgill commented 1 year ago

@chr78rm & @slandelle, any chance this PR could be resurrected? it looks like it was almost over the line :)

chr78rm commented 12 months ago

Not this one, but I can provide an updated PR rooted at the latest commit from @slandelle in due course, if desired.

I have to note although, that I have observed some regressions regarding the generation of scaladocs beginning with Scala version 3.2.0. The same regressions can be reproduced by the direct usage of scaladoc via command line. The scaladocs will be produced but they have some defects, e.g. the links can only be followed by opening a new tab.

You might have noticed, that the documentation concerning Scala builds - inclusive the generation of scaladocs - at the EPFL in Lausanne is centered around the scala build tool (sbt), see e.g. https://dotty.epfl.ch/docs/contributing/scaladoc.html.

Perhaps the invocation via sbt adds some magic which is currently missing (at least starting with Scala version 3.2.0). That is, the invocation of scaladoc might have to be tweaked for the recent versions. Someone might have to reach out to the scaladoc team at the EPFL for clarification.

alexfoxgill commented 11 months ago

thanks @chr78rm, it seems like perhaps maven and scala are just not meant to be; we'll explore some other avenues

slandelle commented 11 months ago

@alexfoxgill Honestly, even as a maintainer of this project (will low bandwidth), this is also my feeling.

AFAIK, the main interest for Scala with maven come from:

If there isn't more contributions from power users, this plugin is going to stall in terms of innovation.