NonStop Server for Java 5.0 Programmer's Reference

enclosed text is interpreted as not containing HTML markup or nested javadoc tags.
For example, the doc comment text: {@literal a<B>c} displays in the generated
HTML page unchanged: a<B>c  that is, the <B> is not interpreted as bold.
The {@code} tag formats literal text in the code font; {@code abc} is equivalent to
<code>{@literal abc}</code>.
Tag {@value arg}  This inline tag now accepts the name of a program element:
{@value package.class#field}.
You are now able to use the tag in any doc comment, not just in the doc comment of the
constant field.
●
package-info.java  You can now create a source file with this name to store
package comments and annotations. You can use this package in place of
package.html (which supports only comments, not annotations). If package-info.java
is present, javadoc should ignore package.html and look instead for the package
doc comment immediately preceding the (possibly annotated) package declaration. The
javadoc tool handles the selection and parsing of package-info.java and
package.html and passes the doc comments to the doclet.
●
@Deprecated annotation  A new annotation in 5.0 that you should use in addition to the
@deprecated tag for deprecating program elements. The Java language specification
now requires compilers to issue warnings when the @Deprecated annotation (but not
necessarily the tag) is used. The @deprecated tag provides a place to describe what
replaces the deprecated program element. For more information, see @@Deprecated
annotation in How and When to Deprecate APIs.
●
Annotation Processing Tool (apt)
The apt tool is a command-line utility for annotation processing. The apt tool includes a set
of reflective APIs and supporting infrastructure to process program annotations (JSR 175).
These reflective APIs provide a build-time, source-based, read-only view of program structure.
They model the Java programming language's type system after the addition of language
generics (JSR 14). apt first runs annotation processors that can produce new source code and
other files. Next, apt can cause compilation of both original and generated source files, thus
easing the development cycle. For more information, see apt.