@title Roxygen 中缺少名称

Question

我有 R6Class 的文档：

#' Root component that don't have parent,
#'
#' It should not be used directly, only using \code{\link{pkg::component}} function.
#'
#' @name BaseComponent
#' @importFrom R6 R6Class
#' @docType class

#' @keywords components, architecture, structure

和 roxygen 显示警告：

Warning: [c:\projects\pkg\R\components.R:1] @title Missing name

我不知道为什么它显示第 1 行，我的代码不在第 1 行。

添加@title 不会改变任何内容我一直收到此警告。

Answer 1

警告混淆了文件的最后一行：

#' init extend on base battery component
BaseComponent$extend <- make.extend(BaseComponent)

用 ## 替换 #' 解决了这个问题。

Answer 2

我遇到了同样的问题。这是由与包函数相同的文件中的以下代码行引起的：

utils::globalVariables(c("."))

因为警告 no visible binding for global variable ‘.’

我使用了它

将该行移动到我的 R 文件夹中它自己的文件后，我不再收到该消息。

Answer 3

在我的例子中，警告出现是因为 @example 部分中的 non-ASCII-character：

#' @examples
#' \dontrun{
#' find_address(state = "Bayern",
#'              org = "Universität",  <-- the "ä" is the causing the warning
#'              page_size = 10)
#' }

roxygenise 现在可以使用示例参数 org = "Hochschule".

@title Roxygen 中缺少名称

@title Missing name in Roxygen

r

roxygen