Comments in doclet xml files which contain the less than entity (
<) result in an invalid description. Example from the BigNumbers library with the following comment. Removing the entity fixes the issue.
<comment>Returns the length of the value's two's complement representation without leading zeros for positive numbers / without leading ones for negative values. The two's complement representation of this will be at least bitLength() + 1 bits long. The value will fit into an int if bitLength() < 32 or into a long if bitLength() < 64.</comment>