Javadoc 是否有等价于 <![CDATA[ ... ]]>? [英] Does Javadoc have an equivalent to <![CDATA[ ... ]]>?

问题描述

不幸的是，HTML 中没有 CDATA.

Unfortunately, there is no CDATA in HTML.

这很遗憾，因为它非常适合添加包含 XML 的 javadoc 注释，因此您不必转义 <和 >，例如:

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=""> ]]>*/

但是，javadoc 可以识别 CDATA 部分，并将其转换为 HTML.例如:

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="">

或者它可以使用一些比 CDATA 更​​简单的语法.因为 javadoc 是可扩展的，所以可能有人添加了这个功能；或者也许 javadoc 已经把它埋在里面的某个地方......有人知道吗?

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?

推荐答案

你可以使用 JavaDoc 的 @code 标签:/** 这样解析 {@code <complexType name="">} */

You can use JavaDoc's @code tag: /** This parses {@code <complexType name="">} */

这篇关于Javadoc 是否有等价于 &lt;![CDATA[ ... ]]&gt;?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！