Scaladoc吞下了“抛出”和“注意”标记

Question

在创建Scala文档时，我还使用了@throws和@note标记，比如文档化的这里(Scaladoc Wiki -标记和注释)。

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

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

顺便说一句:使用Scala2.9.0.1的scaladoc Ant任务也不会发出警告。

编辑： BTW2并澄清:我不是指@throws注释

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

这在这个def的注释部分中有记录，但是Scaladoc的@throws标记类似

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

Answer 1

这是一个bug和一些还没有进入发行版的东西的组合。

@注意事项不起作用，这是一个已知的错误，请参阅@todo，“注意到”和“示例不起作用”？

@ this是最近才添加的，参见2011年7月合并的拉请求 from 西蒙·奥赫森雷瑟。这还没有进入发布阶段，2.9.0.1于2011年5月发布，2.9.1于2011年7月开始发布。

Answer 2

我是半年前@note的。

如果您看一下这里，它似乎是正确的：scala.util.matching.Regex

其他的东西是@throws ScalaDoc标记。实际上，我正在考虑删除对它的支持，以支持@throws注释，因为我看不到任何用例，人们更喜欢使用ScalaDoc标记而不是注释。

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

编辑:嗯。从scala.Array的角度看，它看起来是相反的.