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

[Pavel Rappo]

On Mon, 3 May 2021 17:52:12 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.
>
> Hannes Wallnöfer has updated the pull request incrementally with one additional commit since the last revision:
> 
>   JDK-8250766: Add comments

1. Is whitespace immediately preceding `(` expected to be retained? For example, in


@see        java.net.URL#URL
            (java.lang.String,
             ...


2. Can ReferenceTree.getSignature return null? I dislike unnecessary null checks.
3. The test should also check for whitespace around `,` and `.`

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

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