xml - 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、——promiscuous、——op-name

我认为您不能运行 2.4.3 - 您在示例中指定的选项不适用于此版本。我刚刚下载了最新的 gem 并确认了这一点：

$ rdoc --format=xml --opname=api.xml 
invalid argument: --format=xml

也许您安装了较早版本rdoc的$PATH?

我尝试rdoc 1.0.1并得到了您描述的行为（XML 输出，没有方法）。所以看起来你的问题的答案是“不，这是不可能的（有问题，现在不支持）”。

您可以尝试将其建议为功能请求，尽管这听起来暂时不会发生，如果有的话。