Unfortunately, there is no CDATA in HTML.
This is a pity, because it would be perfect for adding javadoc
comments that include XML, so you don't have to escape the < and >, for example:
/**<![CDATA[ This parses <complexType name=""> ]]>*/
However, it would be possible for javadoc
to recognize the CDATA section, and convert it to HTML for you. For example:
This parses <complexType name="">
Or it could use some simpler syntax than CDATA. Because javadoc
is extensible, it's possible someone has added this functionality; or maybe javadoc
already has it buried somewhere inside... Does anybody know?
See Question&Answers more detail:
os 与恶龙缠斗过久,自身亦成为恶龙;凝视深渊过久,深渊将回以凝视…