如标题所述,我在用roxygen2生成R软件包文档时遇到问题。
我已经按照here and here的说明准备了一切,我99.9%的乐观。我知道几乎不可能获得像这样的主要远程诊断的答案,但是我必须试一试。
这是我使用document()
后看到的
> document()
Updating mypack documentation
Loading mypack
Writing NAMESPACE
There were 7 warnings (use warnings() to see them)
> warnings()
Warning messages:
1: fun1.Rd not generated by roxygen2. Skipped.
2: fun2.Rd not generated by roxygen2. Skipped.
...
看来我已经正确安装了
devtools
和roxygen2
-没有错误。如果它很重要:我有几个.R文件,里面带有几个函数,但是所有函数都有描述。
为了确保并验证一个奇怪的行为,我使用了两个页面的确切示例-这些页面也被跳过了。这有什么问题吗?在这一点上,大胆的猜测是可以的。
谢谢!
最佳答案
This warning通常是因为.Rd
文件已经存在于man
目录中(您是否手动创建了它们,也许是在项目的早期版本中?)。如果roxygen2的开头不是自动生成的行,则roxygen2不会替换它们:
% Generated by roxygen2 (4.1.0): do not edit by hand
要解决此问题,请删除
.Rd
目录中的man
文件,然后重新运行document()
。