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

2021-05-04 Thread Hannes Wallnöfer
On Mon, 3 May 2021 17:52:12 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 >> ope

Re: JEP 413: Code Snippets in Java API Documentation

2021-05-04 Thread Pavel Rappo
Thanks for relaying that Twitter discussion. Although we've surveyed multiple systems before agreeing on the snippet markup syntax that satisfies the needs of our initial use case, OpenJDK, it is possible that we've missed some important features. What are the important features of AsciiDoc's T

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

2021-05-04 Thread Pavel Rappo
On Mon, 3 May 2021 17:52:12 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 >> ope