Roxygen2 无法处理以下划线开头的文件？

Question

我有一些小功能，我想添加到 R package 中。 我在一个文件中列出了所有函数，每个函数前面都有 Roxygen2 指示用于构建帮助文件（下面的示例）。 这一切都很好。 但是，我注意到当我将该文件重命名为以下划线开头（以便它出现在我的文件列表中的第一个位置）时，我收到以下错误消息：

Updating mypackage documentation
Loading mypackage
Writing NAMESPACE
Writing NAMESPACE
Warning message:
In setup_ns_exports(path, export_all, export_imports) :
  Objects listed as exports, but not present in namespace: a, b

这是 R 子文件夹中唯一文件的内容：

#' @name a
#' @title the a() function does etc.
#' @description etc.
#' @param x a dataframe containing etc.;
#' @param v a vector containing etc..
#' @return a dataframe of the etc.
#' @export a
a <- function(x, v) { return("somevalue") }

#' @name b
#' @title the b() function does etc.  
#' @description etc.
#' @param x a dataframe containing etc.;
#' @param v a vector containing etc..
#' @return a dataframe of the etc.
#' @export b
b <- function(x, v) { return("some other value") }

当我删除下划线并重新运行devtools::document()两次时，错误消息消失了。 我把下划线放回去，错误又回来了。 当没有 Roxygen2 标签时，没有错误并且功能运行良好。

这是正常行为吗？ 有没有办法解决这个错误，还是我应该放弃使用下划线的想法？

Answer 1

这不是（只是） roxygen2 ，而是 R 的事情。

从编写 R 扩展，第1.1.5 小节 Package 子目录：

R子目录仅包含 R 代码文件。 要安装的代码文件必须以 ASCII（小写或大写）字母或数字开头，并具有扩展名.R 、 .S 、 .q 、 .r或.s之一。

相似地，

man子目录应该（仅）包含R 文档(Rd) 格式的 package 中对象的文档文件。 文档文件名必须以 ASCII（小写或大写）字母或数字开头，并具有扩展名.Rd （默认）或.rd 。

这通常不是使用roxygen2的问题：虽然它确实根据 function 名称命名.Rd文件，并且 R 不允许 ZC1C425268E68385D1AB5074C17 名称开头的 ZC1C425268E68385D1AB5074C17A 来自R 语言定义小节10.3.2 标识符：

标识符由一系列字母、数字、句点 ('.') 和下划线组成。 它们不得以数字或下划线或句点后跟数字开头。

虽然可以使用以下划线开头的标识符来定义 function，但它需要将 function 名称包装在反引号中以便定义和任何时候使用它（因为它不是“有效标识符”）。