Details
-
Type:
Bug
-
Status: Resolved
-
Priority:
P4
-
Resolution: Fixed
-
Affects Version/s: 9
-
Fix Version/s: 9
-
Component/s: client-libs
-
Subcomponent:
-
Resolved In Build:b133
Description
Including HTML entities inside {@code} tags results in incorrect javadoc. For example
* @throws NullPointerException if {@code tag == null}.
generates
NullPointerException - if tag == null.
which is clearly not what was intended. The above case should be corrected for example to be
* @throws NullPointerException if {@code tag == null}.
or
* @throws NullPointerException if {@code tag} is {@code null}.
Another case is
* @throws IllegalArgumentException if {@code count < 0}.
which generates
IllegalArgumentException - if count < 0.
and should be changed instead to
* @throws IllegalArgumentException if {@code count < 0}.
* @throws NullPointerException if {@code tag == null}.
generates
NullPointerException - if tag == null.
which is clearly not what was intended. The above case should be corrected for example to be
* @throws NullPointerException if {@code tag == null}.
or
* @throws NullPointerException if {@code tag} is {@code null}.
Another case is
* @throws IllegalArgumentException if {@code count < 0}.
which generates
IllegalArgumentException - if count < 0.
and should be changed instead to
* @throws IllegalArgumentException if {@code count < 0}.