New candidate JEP: 413: Code Snippets in Java API Documentation

2021-04-28 Thread mark . reinhold
https://openjdk.java.net/jeps/413 Summary: Introduce an @snippet tag for JavaDoc's Standard Doclet, to simplify the inclusion of example source code in API documentation. - Mark

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

2021-04-28 Thread Pavel Rappo
On Wed, 28 Apr 2021 07:47:23 GMT, Hannes Wallnöfer 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 > openin

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

2021-04-28 Thread Hannes Wallnöfer
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. - Com