RFR: JDK-8250766: javadoc adds redundant spaces when @see program element is wrapped

[Jonathan Gibbons]

On Wed, 28 Apr 2021 07:47:23 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> This changes reference parsing in `DocCommentParser` to normalize whitespace in signatures to a large extent. In particular, multiple whitespace characters are coalesced into a single space character, and whitespace after opening parentheses and angle brackets are suppressed.

This is against the general philosophy of `DocCommentParser`, which is to try and retain input formatting as much as possible. 

It would be better to normalize the whitespace downstream (i.e. in javadoc HTML world) when creating output based on the signature.

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

Changes requested by jjg (Reviewer).

PR: https://git.openjdk.java.net/jdk/pull/3754