【问题标题】:Roxygen2 skipps .Rd generationRoxygen2 跳过 .Rd 生成
【发布时间】:2015-07-06 14:50:59
【问题描述】:

正如标题所说,我在使用 roxygen2 生成 R 包文档时遇到问题。 我有 99.9% 的信心已经按照 here and here 的解释准备好了一切。我知道几乎不可能得到像这样的主要远程诊断 - 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.
...

看来我已经正确安装了devtoolsroxygen2 - 没有错误。

如果它很重要:我有几个 .R 文件,里面有几个函数,但所有函数都有描述。

为了确保和验证奇怪的行为,我使用了两个页面的确切示例 - 那些也被跳过了。这里有什么问题?在这一点上,胡乱猜测是可以的。

谢谢!

【问题讨论】:

    标签: r devtools roxygen2


    【解决方案1】:

    This warning 通常是因为.Rd 文件已存在于man 目录中(您是否手动创建它们,也许是在项目的早期版本中?)。如果它们不是以表明它们是自动生成的行开头的,则 roxygen2 不会替换它们,如下所示:

    % Generated by roxygen2 (4.1.0): do not edit by hand
    

    要解决这个问题,请删除man目录下的.Rd文件,然后重新运行document()

    【讨论】:

    • 快速评论/问题:我第一次开发一个包,当我第一次运行 devtools::document 时,它没有给我这个警告并且有一个评论 ``第一次使用 roxygen2 4.0.在输出中自动升级...''。当我将 cmets 添加到我的第二个函数并第二次运行 devtools::document 时,我只遇到了问题中的“跳过”问题
    • @gvrocha 啊,很高兴知道。之后删除文件是否有效?
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2015-06-25
    • 2017-07-24
    • 1970-01-01
    • 2015-05-22
    • 2016-07-10
    • 2014-06-26
    相关资源
    最近更新 更多