Roxygen2 skipps .Rd代
Roxygen2 skipps .Rd generation
正如标题所说,我在使用 roxygen2 生成 R 包文档时遇到问题。
我 99.9% 肯定已经按照解释 here and here 准备好所有内容。我知道几乎不可能得到像这样的 prime remote diagnosis-nono-case 的答案,但我必须试一试。
这是我使用后看到的 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 不会替换它们,如下所示:
% Generated by roxygen2 (4.1.0): do not edit by hand
解决这个问题,删除man
目录下的.Rd
文件,然后重新运行document()
.
正如标题所说,我在使用 roxygen2 生成 R 包文档时遇到问题。 我 99.9% 肯定已经按照解释 here and here 准备好所有内容。我知道几乎不可能得到像这样的 prime remote diagnosis-nono-case 的答案,但我必须试一试。
这是我使用后看到的 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 不会替换它们,如下所示:
% Generated by roxygen2 (4.1.0): do not edit by hand
解决这个问题,删除man
目录下的.Rd
文件,然后重新运行document()
.