题
我正在尝试使用 XML 格式生成 RDoc。这是我正在使用的命令:
$ rdoc --fmt=xml --opname=api.xml
文件已创建,但未生成方法列表。我在用着 rdoc (2.4.3)
. 。XML 的 RDoc 模板包含用于方法显示的标签。
是否可以?
解决方案
从 2.4 开始,不再支持 XML 输出。参见例如 这个博客 由维护者之一:
将 HTML 和 XML 生成器移至不再维护的位置
- 不会提供宝石,因为让它们发挥作用太困难了
- 删除了选项—one-file、—style=、—inline-source、—promiscously、—op-name
我认为您不能运行 2.4.3 - 您在示例中指定的选项不适用于此版本。我刚刚下载了最新的 gem 并确认了这一点:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
也许您有旧版本 rdoc
已安装,较早出现在您的 $PATH
?
我试过 rdoc 1.0.1
并得到您所描述的行为(XML 输出,无方法)。所以看起来你的问题的答案是“不,这是不可能的(有问题,现在不支持)”。
您可以尝试建议将此作为 功能要求, ,尽管听起来这在一段时间内不会发生(如果有的话)。
不隶属于 StackOverflow