R包在DESCRIPTION中声明作者

Question

我的说明文件如下所示（仅显示相关部分）。

Author: John Doe
Authors@R: person("John", "Doe", email = "john.doe@email.com",role = c("aut", "cre"))
Maintainer: John Doe <john.doe@email.com>

devtools::check()、R CMD check 和 R CMD build 可以正常完成。但是，CRAN 提交返回此注释：

  * checking DESCRIPTION meta-information ... NOTE
Author field differs from that derived from Authors@R
Author:    'John Doe'
Authors@R: 'John Doe [aut, cre]'

不知道那是什么。无论如何，检查documentation，它说：

“Author”和“Maintainer”字段可以从“Authors@R”自动生成，如果提供了后者，则可以省略。

所以，我删除了作者和维护者。现在当我在本地运行 R CMD check 时：

* checking for file ‘./DESCRIPTION’ ... ERROR
Required fields missing or empty:
  ‘Author’ ‘Maintainer’

最好的方法是什么？

更新

我删除了 Authors@R 并保留了 Author 和 Maintainer 原样。所有本地测试都通过了。但是，CRAN 对此表示不满。

* checking CRAN incoming feasibility ... NOTE
Maintainer: 'John Doe <john.doe@email.com>'

但是，我不明白。

更新

此问题已记录在 here。

Answer 1

您可以使用作者和维护者或作者@R。在后一种情况下，我会省略作者和维护者，因为它们由R CMD build 填充。这让我想到了最重要的一点：永远不要在源目录上运行 R CMD check，而只能在 R CMD build 创建的 tar.gz 上运行！

否则你会因为不寻常的文件（.Rbuildignore不考虑），src中存在目标文件，...。

顺便说一句，根据我的经验，使用 devtools::check() 很好，但知道幕后发生的事情总是很好。

Answer 2

似乎R CMD check . 没有编译Authors@R 字段。运行R CMD build . 然后运行R CMD check mypkg.tar.gz 似乎可以更好地重现构建系统上发生的情况。我也喜欢使用devtools::check()，因为它会在运行检查之前重建 roxygen 文档。

顺便说一句，根据您链接的文档，我认为您应该使用 person("John", "Doe", role = c("aut", "cre")) 而不是 John Doe [aut, cre]。