Scaladoc吞噬了@throws和@note标签

在创建 Scala文档时,我还使用@throws和@note标记,如文档 here (Scaladoc Wiki – Tags and Annotations)所示.

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

是否必须设置某些开关,考虑具体的事情或这是一个已知的问题?

顺便说一句:使用Scala 2.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

解决方法

这是一个bug和尚未成为发行版的东西的组合.

@note不起作用,这是一个已知的bug,见@todo,@note and @example don’t work?

@throws最近才被添加,见0700年0700,这是在2011年7月合并.这还没有发布,2011年5月发布了2.9.0.1,2011年7月发布了2.9.1.

相关文章

共收录Twitter的14款开源软件,第1页Twitter的Emoji表情 Tw...
Java和Scala中关于==的区别Java:==比较两个变量本身的值,即...
本篇内容主要讲解“Scala怎么使用”,感兴趣的朋友不妨来看看...
这篇文章主要介绍“Scala是一种什么语言”,在日常操作中,相...
这篇文章主要介绍“Scala Trait怎么使用”,在日常操作中,相...
这篇文章主要介绍“Scala类型检查与模式匹配怎么使用”,在日...