This post originated from an RSS feed registered with Java Buzz by Marc Logemann. Original Post: no more Entities in Javadoc 1.5 Feed Title: Marc's Java Blog Feed URL: http://www.logemann.org/day/index_java.xml Feed Description: Java related topics for all major areas. So you will see J2ME, J2SE and J2EE issues here. Latest Java Buzz Posts Latest Java Buzz Posts by Marc Logemann Latest Posts From Marc's Java Blog

I recently crawled through the javadoc reference and found that for 1.5, two new tags arrived:

@code and @literal

--- (excerpt from sun reference) ---

{@code text}
Equivalent to {@literal}.

Displays text in code font without interpreting the text as HTML markup or nested javadoc tags. This enables you to use regular angle brackets (< and >) instead of the HTML entities (< and >) in doc comments, such as in parameter types (

{@literal text}
Displays text without interpreting the text as HTML markup or nested javadoc tags. This enables you to use regular angle brackets (< and >) instead of the HTML entities (< and >) in doc comments, such as in parameter types (

--- end excerpt ---

Nothing too exciting but we no longer need to escape html chars anymore. This is in fact quite useful because we live in a parametrized world now, and i really dont want to type things like this in the docs:

Collection c = new ArrayList&lt;Article&gt;()