RDoc XML 生成

Question

我正在尝试使用 XML 格式生成 RDoc。这是我正在使用的命令：

$ rdoc --fmt=xml --opname=api.xml

文件已创建，但未生成方法列表。我在用着 rdoc (2.4.3). 。XML 的 RDoc 模板包含用于方法显示的标签。

是否可以？

Answer 1

从 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 输出，无方法）。所以看起来你的问题的答案是“不，这是不可能的（有问题，现在不支持）”。

您可以尝试建议将此作为 功能要求, ，尽管听起来这在一段时间内不会发生（如果有的话）。