Following 2.7.4: can't find a way to keep first line blank in docstrings with docstrings = Scaladoc / docstrings.style = SpaceAsterisk

[neko-kai]

version = 2.7.4
docstrings = ScalaDoc

Steps

Given code like this:

/**
  * abc
  * cba
  */
def x: Unit = ()

Problem

Scalafmt formats code like this (with either setting for docstrings.wrap):

/** abc cba
  */
def x: Unit = ()

Expectation

I would like the formatted output to look like this:

// docstrings.wrap = false // keep starting newline as in 2.7.3
/**
  * abc
  * cba
  */
def x: Unit = ()

// docstrings.wrap = true // fold everything?
/** abc cba */
def x: Unit = ()

Workaround

None

Notes

None

[kitbellew]

https://docs.scala-lang.org/style/scaladoc.html:

Note that, in contrast to the Javadoc convention, the text in the Scaladoc styles begins on the first line of the comment.

I can add a new docstrings = AsIs which will not format the docstring at all. Including indent and leading asterisks.

[neko-kai]

@kitbellew
I understand the recommendation, but it's not really followed universally, even in scala/scala. Scalafmt sorting out with the leading asterisks is a big help, so omitting all formatting would be regrettable. Maybe a separate option, such as docstrings.spaces = fold/unfold ?