Hi Pavel, you added a comment to the issue, that you prefer the *<code>* tag for large code fragments instead of the *...@code* tag.
The advantage of the *...@code* tag is however that it escapes the angle brackets of generic code statements, while with the *<code>* tag, one has to escape the angle brackets explicitly, which makes the Javadoc in the source files much less readable. So what do you recommend for large generic code fragements: 1. *...@code* 2. *<code>* and explicitly escaped angle brackets 3. ... https://bugs.openjdk.java.net/show_bug.cgi?id=100029 -Florian
