r - 调试 Roxygen 2 文档

Question

我有一个非常大的项目，有大约 120 个文件，每个文件有大约 50 行文档。Roxygen2 是记录我的代码的救星，但我在修复损坏的文档时遇到了一些棘手的问题。当我从 Rstudio 运行 roxygenise 时，出现以下错误。

==> roxygenize('.', roclets=c('rd', 'namespace'))

* checking for changes ... ERROR

Error : family requires a value

该消息相当清楚，但不清楚它来自哪个文件。我在项目中有超过 500 个家庭标签，因此手动搜索它们并不容易，当然也不是一个长期的解决方案。

有没有办法将 roxygen 错误本地化到特定文件？我想这可以通过循环中的每个文件来实现，但我不知道如何做到这一点。

任何帮助、煽动或脚本将不胜感激，如果需要任何澄清，请在下面发表评论。

score 3 · Accepted Answer

如果您在 UNIX 系统或带有 cygwin 的 Windows 上，您可以运行：

grep -r -e "@family\s*$" ./

从您的文件所在的目录中。如果不是大多数文本编辑器都有一个正则表达式在文件中查找选项。

如果问题是您的家庭标签格式不正确而不是仅仅丢失，这并不能保证成功，但可能会起作用。如果是后一个问题，那么您应该从@BenBolker 的建议开始。

1 回答 1