使用 HTML 转义。
所以在你的例子中:
/**
* Returns true if the specified string contains "*/".
*/
public boolean containsSpecialSequence(String str)
/
转义为“/”字符。
Javadoc 应该将不受干扰的转义序列插入到它生成的 HTML 中,并且应该在浏览器中呈现为“*/”。
如果你想非常小心,你可以转义两个字符:*/
转换为*/
编辑:
跟进:看来我可以使用 / 为斜线。唯一的缺点是,当直接查看代码时,这并不是那么可读。
所以?重点不是让您的代码可读,而是让您的代码文档可读。大多数 Javadoc 注释都嵌入了复杂的 HTML 以进行解释。地狱,C# 的等价物提供了一个完整的 XML 标记库。我在那里看到了一些非常复杂的结构,让我告诉你。
编辑 2:
如果它太困扰您,您可能会嵌入一个解释编码的非 javadoc 内联注释:
/**
* Returns true if the specified string contains "*/".
*/
// returns true if the specified string contains "*/"
public boolean containsSpecialSequence(String str)