如何在不覆盖所有其他文件的情况下对单个文件运行rdoc？

Question

我正在做一个非常大的rails项目，我想在代码库中标准化rdoc的使用。我想我可以在整个项目中运行一次(至少为类和方法本身生成文档)，然后开发人员可以在添加文档时添加单个文件。

问题是，如果我运行rdoc /path/to/some_file.rb，它会从生成的index.html中删除所有其他文件，并且只包含一个文件。在整个项目上运行rdoc需要3-4分钟，并且不需要在每次添加新注释时都解析整个项目。rdoc --help的输出没有提供任何解决方案。

有没有办法配置rdoc，使它始终持久化文档，直到我再次专门对这些文件运行rdoc？

谢谢你的见解！

Answer 1

我不认为rdoc从index.html中删除了任何东西，只是覆盖了它，实际上没有能力修改它。关于性能，我不是百分之百确定，但最有可能的是rdoc不缓存解析结果。有了-c, --use-cache选项，Yard就做到了，而且它显著地提高了速度。