在创建Scala文档时,我还使用了这里记录的@throws
和@note
标签(Scaladoc Wiki - Tags and Annotations).
不幸的是我在生成的Scaladoc中找不到这些.
是否必须设置某些开关,考虑具体的事情或这是一个已知的问题?
顺便说一句:使用Scala 2.9.0.1 的scaladoc
Ant任务也没有发出警告.
编辑: BTW2并澄清:我不是指@throws
注释
@throws(classOf[RuntimeException])
def dispatch: Nothing = throw new RuntimeException
Run Code Online (Sandbox Code Playgroud)
这是在注释部分记录的,def
但@throws
Scaladoc 的标签就像
/** @throws RuntimeException
*/
def dispatch: Nothing = throw new RuntimeException
Run Code Online (Sandbox Code Playgroud)
这是一个错误和尚未发布的内容的组合。
@note 不起作用,这是一个已知的错误,请参阅@todo、@note 和 @example 不起作用?
@throws 最近才添加,请参阅Simon Ochsenreither的拉取请求,该请求于 2011 年 7 月合并。尚未发布,2.9.0.1 于 2011 年 5 月发布,2.9.1 于 7 月启动2011年。