<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