6

在创建 Scala 文档时，我还使用此处记录的@throws和@note标记(Scaladoc Wiki - Tags and Annotations)。

不幸的是，我在生成的Scaladoc中找不到这些。

是否必须设置某些开关，考虑特定的事情还是这是一个已知问题？

顺便说一句：使用 Scala 2.9.0.1 的scaladoc Ant 任务也不会发出警告。

编辑：顺便说一句，澄清一下：我不是指@throws注释

@throws(classOf[RuntimeException])
def dispatch: Nothing = throw new RuntimeException

这在注释部分中有记录，def但@throwsScaladoc 的标签如

/** @throws RuntimeException
 */
def dispatch: Nothing = throw new RuntimeException
4

2 回答 2

3

这是一个错误和尚未发布的内容的组合。

@note 不起作用，这是一个已知错误，请参阅@todo、@note 和 @example 不起作用？

@throws 是最近才添加的，请参阅Simon Ochsenreither的这个pull request，它于 2011 年 7 月合并。这还没有发布，2.9.0.1 于 2011 年 5 月发布，2.9.1 于 7 月开始2011 年。

于 2011-09-13T11:12:59.290 回答
3

我在半年前添加了支持。@note

如果您在这里查看，它似乎可以正常工作：scala.util.matching.Regex

另一件事是@throwsScalaDoc 标签。实际上，我正在考虑删除对它的支持以支持@throws注释，因为我看不到任何使用 ScalaDoc 标记而不是注释的用例。

如果您有真正的需要，请让我不，让我知道！

编辑：嗯。看着scala.Array它实际上看起来是相反的......

于 2011-09-13T11:13:07.180 回答