R 包创建函数名称和 .R/.rd 名称

Question

.R 和 .rd 文件(文档)的名称是否需要与它所指的函数具有完全相同的名称？

例如，我能否在同一个 R 包中拥有一个名为“b”的函数和另一个名为“B”的函数，并将文档写入不同的 .R 和 .rd 文件中？

我有点困惑，我找不到遇到同样问题的人(我什至在 DataCamp 的类(class)上查过)，所以提前致谢。

此致!

Answer 1

由于 .R 文件可以包含许多函数，因此它不需要与它所引用的函数具有完全相同的名称。

关于 .Rd 文件，让 Roxygen 转 specially formatted comments 更容易/有效/实用到 .Rd 文件。

在 Windows 上(文件不区分大小写)避免使用大写/小写来区分函数，因为其中一个函数的 .Rd 文件将被覆盖:

Updating package documentation
Loading package
Writing NAMESPACE
Writing FOO.Rd
Writing foo.Rd

#' foo
#'
#' A function to print bar
#'
#' @param bar 
#'
#' @return prints input
#' @export
#'
#' @examples
#' foo(1)
#' 
foo <- function(bar) { print(bar) }

#' FOO
#'
#' Another function to print bar
#'
#' @param bar 
#'
#' @return prints input
#' @export
#'
#' @examples
#' foo(1)
#' 
FOO <- function(bar) { print(bar) }

?foo