RFR: 8342808: Javadoc should add whitespace between type parameters

[Pavel Rappo]

On Thu, 31 Oct 2024 13:50:31 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> I'm not sure about this change.

IIRC, this feature was suggested by @minborg elsewhere. It would be nice if he advocated for it. Per, do you have anything to say here? Maybe other core-libs people have opinions on it?

> For the common case of single uppercase letter parameter names, I actually find the notation without space character more readable, and that also seems to be the convention in most OpenJDK code.

We use a mix of styles in code. However, in javadoc output, we should be uniform similarly to how we are uniform with method and constructor parameters, which we always separate with whitespace.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/21759#issuecomment-2450164890