would you be ok with replacing "<" with "&lt;" resp. ">" with "&gt;" or do you prefer another format altogether? I know Kevin used the same format, but in fact that is illegal javadoc syntax. We are planning to move to Java 8 soon where the javadocs correctness is actually enforced. Latest then we will have to take care of this. WDYT?