如何在Roxygen中显示返回列表的元素？

Question

通过这样做，我可以通过多行@param轻松完成输入参数：

#' @param var1 This is for x
#' @param var2 This is for y
#' @param var3 This is for Z

但是你如何为你要返回的列表的元素做到这一点。我想要包含每个元素的名称和关于它们的描述。将@return或@param链接在一起的行为不同。什么是合适的标签？

#' @return A list with the following elements:
#' @something element1 Contains x
#' @something element2 Contains y
#' @something element3 Contains z

包samr具有我正在寻找的确切降价格式：

Answer 1

来自手册 - http://roxygen.org/roxygen2-manual.pdf

@return用于记录函数返回的对象。对于列表，请使用\ item {name a} {description a}描述列表的每个组成部分

Answer 2

由于链接在其他答案中断开，因此我提供了roxygen文档的简单示例，该文档提供了一个将列表作为返回值的函数。

#' Sample function that returns a list and uses roxygen documentation.
#'
#'
#' @return A list with letters and numbers.
#' \itemize{
#'   \item A - The letters of the alphabet.
#'   \item B - A vector of numbers.
#' }
myfunction <- function() {
  list(
    A = LETTERS,
    B = 1:10
  )
}

这是基于指向R packages - Object Documentation - Text formatting reference sheet

的链接的