如何在Groovy/Grails中记录taglib(或一般的闭包)

Question

我正在编写我的第一个taglib作为插件的一部分,我想记录它.添加javadoc(有没有文件groovydoc的地方或它真的是一样的东西？)似乎不适用于非方法.

具体来说,如何记录def mytag:

/**
 * This doc shows up
 */
class MyTagLib {
  static namespace = "myns"

  /**
   * This doc does not show up, but I'd like to document attrs.
   */
  def mytag = {attrs ->
    out << "something"
  }
}

因为使用闭包指定了Grails中的很多东西,如果它真的无法记录它们,那么看起来我们遇到了问题.是否有其他解决方案涉及我应该使用的单独的文档文件？

Answer 1

我刚刚读到了有关新的 Groovy 1.6 RC 的信息，这让我找到了 Jira，它有几个与 groovydoc 有关的未解决的错误，其中包括一个专门关于记录字段和属性的错误，该错误仍然处于打开状态。最新的评论谈到了主干中的部分实现，所以我必须检查一下。

这样就清楚了当前的状态。与此同时，我强迫自己将我的 taglib 发布到野外，并对其进行记录，我使用常规 HTML 页面（wiki 生成的）来完成此操作。对此有一些话要说，因为如果发现带有标签库详细信息的唯一文档被埋在大量自动生成的垃圾中，我实际上会被推迟。