bad option `-doc-external-doc` on Scala 3 about mouse HOT 6 CLOSED

Yes, my original investigation suggested that sbt was using this legacy flag instead of the flag for Scala 3 -external-mappings, which is reported in sbt/sbt#6652.

But, what is strange is why the legacy flag would be a "bad option": even though it is deprecated, it should be supported. So my best guess is that you need some extra flag that indicates that the Scala 3 compiler should work in "2.13 compatibility mode". Probably, sbt-typelevel-settings adds this one. If I had to guess it's this migration one.

https://github.com/typelevel/sbt-typelevel/blob/fb3c7d871e88c3eeef8bc73b57f9f90559c8386a/settings/src/main/scala/org/typelevel/sbt/TypelevelSettingsPlugin.scala#L150

Edit: I see mouse already includes this option:

from mouse.

Oh, I know what this is. I bet if you update to Scala 3.1.1 it will work without changing anything else.

from mouse.

So what is this exactly? :) I've tried to dig into that rabbit hole, but have no results, unfortunately.

from mouse.

What this option does is link to other libraries' API docs from mouse's API docs.

We turned this on in the latest sbt-typelevel release, so you can see the difference between the mouse 1.0.9 docs and the mouse 1.0.10 docs for Scala 2.13. In the 1.0.10 docs you can click on Functor, FlatMap, etc. and it will take you to the cats API docs.

https://www.javadoc.io/doc/org.typelevel/mouse_2.13/1.0.9/mouse/FEitherOps.html
https://www.javadoc.io/doc/org.typelevel/mouse_2.13/1.0.10/mouse/FEitherOps.html

I guess it doesn't matter if it's not working for the Scala 3 docs if nobody is looking at those :)

Edit: btw, I don't know why it's not linking for Scala standard library APIs :(

from mouse.

I'm not sure if this is an issue anymore. I don't see the error anymore in the logs.

from mouse.

Yeah, it seems this is fixed.

from mouse.