<Swing Dev> 6179357: Generics: JList: generic code in Javadoc
Florian Brunner
fbrunnerlist at gmx.ch
Sun Apr 5 17:55:16 UTC 2009
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
More information about the swing-dev
mailing list