微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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.

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐