问题标签 [groovydoc]

我正在使用 Gradle 1.5 来测试我的 Groovy 脚本。build.gradle 中的 groovyDoc 任务设置如下：

运行此任务时出现的错误是：

这只是在我对我的一个类进行了小的代码更改（添加一个 If 语句）之后才开始发生的。我恢复到以前的提交，它没有这个问题。我尝试删除班级中的更改并重新提交相同的文件，但仍然失败。

你有什么想法？

我正在用 Groovy 编写一个类，我想为它生成 Groovydoc（从命令行）。在我的课堂上，我为这样的方法编写了文档：

但是当我跑步时groovydoc -classpath C:\groovyStuff\ -d . *.groovy

它生成 HTML 模板，但没有实际内容。

我做错了什么？

我想在我的 groovy 源代码中创建一个自定义 doclet，但我找不到任何可能性，因为groovydoc工具没有-taglet参数。我在 API 中挖掘了一下，但没有运气。有没有办法编写自定义 doclet？

当我搜索 Groovy javadocs（groovydocs 等）时，我在 Google 中找到了它，但它们都重定向到一种 Groovy 启动页面，说明 Groovy 有多好。例如，当我搜索“groovy uribuilder api”时，链接显示为：

http://groovy.codehaus.org/modules/http-builder/apidocs/groovyx/net/http/URIBuilder.html

但该链接重定向到：

http://beta.groovy-lang.org/modules/http-builder/apidocs/groovyx/net/http/URIBuilder.html

我可以查看 Google 的缓存版本以获取真正的 API 文档，但我担心在某些时候这会消失，我会被半成品的 Groovy 代码和没有文档所困。是否有托管在任何地方的 Groovy 文档的新根？

谢谢

更新：文档再次出现，但答案仍然是很好的信息。

我刚刚开始为我正在开发的库生成 Groovydoc。然而，方法签名中的java.langandjava.util和其他常见包前缀的优势掩盖了方法的真正意图。我希望能够在没有这些的情况下生成 Groovydoc。如（组成）示例：

而不是：

（我的一些真实例子更糟糕，有三四个something.entirely.Obvious参数加上返回值。）

在 Javadoc 中，我会使用该-noqualifier选项来实现这一点。但是，没有列出类似的选项groovydoc --help。

有没有办法用 Groovydoc 做到这一点？如果没有，有没有人想出任何其他可靠的方法来做到这一点？（我的后备方案，我还没有机会尝试，它尝试使用 Ant 的replace任务对生成的文档进行后处理 - 但我想知道是否有更好的方法。）

我在 Groovy 家族的某个地方看到了新的 groovydoc 标记（注释语法）。它类似于 Wiki 标记语言，而不是 Javadoc。我丢失了 url 并且在 google 中找不到 :(。这个文档格式化程序的名称非常简单，是普通的英文单词。有人可以提醒我吗？

我将记录许多 groovy 业务规则脚本，这可能会有所帮助。

我在父目录下的不同位置有 groovy 脚本。目录结构有点像这样：

我想生成 groovy 文档并将每个 groovy 脚本包含在父目录下。

我尝试在父目录上运行命令，它只获取其中的那些，显然，不包括子文件夹中的那些：

如果有比命令行更好的方法？我也试过这个插件，但没有运气https://github.com/rvowles/groovydoc-maven-plugin

谢谢！

对于 Groovy 或 Java 类或方法，我通常会在文档注释（也称为 Javadoc 注释）中包含任何 API 级别的文档，而不是常规注释。添加有关 Groovy 脚本的此类注释的类似方法是什么？

我个人不太关心 Javadoc 工具是否会提取文档。然而，关于 Groovy 脚本用途的文档在概念上似乎类似于对类的文档注释。因此，我直观地希望它们出现在文档评论中。如果我的直觉是错误的并且 doc 标签不是注释 Groovy 脚本意图的标准方法，那么记录脚本目的的首选方法是什么？

grails 2.x 文档功能看起来非常有用/很有希望：http: //grails.github.io/grails-doc/2.5.3/ref/Command%20Line/doc.html

它说命令 »grails doc« - »为当前 Grails 项目生成用户指南和 Javadoc + Groovydoc API 文档。

但是，手册的这一部分在 Grails 3.0.10 中消失了。我在更改日志中找不到相关信息，并且 grails 交互式控制台对 doc 命令一无所知。我使用谷歌，但找不到任何关于此的信息。（我知道 groovydoc 并且我现在使用它，但它不知道开箱即用的 grails 内脏，所以我的问题是存在的）

它去哪儿了？为什么被移除？它会回来吗？

我正在尝试生成 Grails 2.4.3 项目的 Java 文档，但出现错误并且没有生成任何内容。

结果是：

我试图搜索它，但似乎没有其他人遇到这个问题。