search

scala / docs.scala-lang

The Scala Documentation website
http://docs.scala-lang.org
559 stars 1.02k forks source link

Add page about Scala 2 `-Xsource:3` to migration guide #2966

Closed lrytz closed 6 months ago

SethTisue commented 6 months ago

Yeah I'll do the final merge here.

SethTisue commented 6 months ago

new page is online: https://docs.scala-lang.org/scala3/guides/migration/tooling-scala2-xsource3.html

I've linked to it from the 2.13.13 release notes and posted or commented about it on both our forums and on Reddit

lrytz commented 6 months ago

I wonder if we should advertise this right now, given https://github.com/scala/bug/issues/12961. Moving to -Xsource:3-cross changes the encoding of every synthetic case class companion, this can cause issues.

I'll update the page. In any case, the page is entirely missing the fact that case companions are affected by 3-cross, not sure why I missed that when I wrote it.

SethTisue commented 6 months ago

I'll update the page.

👍

I figured it was okay to publish and link to, because in the short run 99% of page visitors will have come there from the 2.13.13 release notes, which already highlight 12961. But yes, of course it would be best if we update it reasonably promptly.