列表项的 Roxygen 文档

Question

我正在学习 Roxygen，到目前为止取得了良好的进展。我已经能够记录我正在处理的大部分包，但有一些地方我似乎无法正确处理。请考虑以下最小 R：

##' Test Roxygen Comments
##'
##' This is a test of the Roxygen System. Had this been actual
##' documentation, it may have contained information about the
##' directives and/or structures below.
##'
##' @name simple
##' @docType data
##' @rdname simple

variable <- list(
                 ##' itema comments
                 itema <- c("bing", "bang", "bong"),

                 ##' itemb comments
                 itemb <- "fooflakes"
)

##' More info abuot variable!
##' @rdname simple

list() 内的注释刚刚被 Roxygen 删除 我已经确认了这一点：

> parse.file("package-test/R/simple.R")
$`1`
$`1`$description
[1] "Test Roxygen Comments\n\nThis is a test of the Roxygen System. Had this been actual\ndocumentation, it may have contained information about the\ndirectives and/or structures below.\n\n"

$`1`$name
[1] "simple\n"

$`1`$docType
[1] "data"

$`1`$rdname
[1] "simple"

$`1`$assignee
[1] "variable"

$`1`$srcref
$`1`$srcref$filename
[1] "package-test/R/simple.R"

$`1`$srcref$lloc
[1] 11  1 17  1  1  1

我有一个选项设置基础设施，我想使用它Roxygen 记录各个选项。我是否缩进注释似乎并不重要，将它们向左移动似乎没有帮助。将 @rdname 添加到每个块似乎也没有帮助。我只是期待不存在的行为吗？在另一个问题中，接受的答案表示我们可以将 Roxygen 评论放在任何地方，并且它们会被收集。

所以有两个方面：我在上面遗漏了什么，以及其他人如果不喜欢我的尝试，如何记录单个数据项？

谢谢你！

Answer 1

Roxygen 不会这样做。我还需要 5 个字符才能作为正式答案。