HTML entities used within @code and @literal tags will be interpreted
directly rather than converted to the expected characters. For example, this is
wrong:
/**
* <pre>{@code
* @Override
* public boolean equals(Object o) {
* return false;
* }
* }</pre>
*/
An option is to drop the {@code } tags, though this will then require escaping
any generic type parameters which may otherwise be interpreted as HTML. That is,
List<Integer> is the text "List" followed by the (non-existent) tag "Integer".
/**
* <pre>
* @Override
* public boolean equals(Object o) {
* return false;
* }
* </pre>
*/
Suppress by applying @SuppressWarnings("EscapedEntity") to the element being
documented.