JEP 413: Code Snippets in Java API Documentation

2021-05-03 Thread Gunnar Morling
Hi all, It's with great interest that I've learned about JEP 413, I think this will be a great improvement to the user experience of JavaDoc! When sharing this online, there was feedback from several folks [1] that alignment for the region selection syntax with that one of AsciiDoc would be desi

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

2021-05-03 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. Hannes Wal

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

2021-05-03 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. Hannes Wal