未导出的 Rd

Question

我正在记录一个内部的、非导出的函数。 roxygen2 正在创建一个 Rd 文件，即使文档中没有 @export 标记。 roxygen2 为以下文档创建了一个 Rd 文件。我错过了什么？

    #' Check validity of a
    #' @param a A logical value
    arg_check_a = function(a) {
      if (!is.logical(a)) {
        stop("a must be a logical value")
      }
    }

Answer 1

使用@noRd .

Use the @noRd tag to prevent .Rd files from being generated.

我也很喜欢将它们标记为 #' @keywords internal，这(根据 vignettes ):

@keywords internal is useful because it removes the function from the documentation index; it’s useful for functions aimed primarily at other developers, not typical users of the package.

(大部分来源于https://github.com/r-lib/roxygen2/issues/684)