为什么devtools给我@slot需要的名称和说明

Question

我已经安装了下面的类在我的定制[R包警告：

#' A stock.returns class is an xts of stock(s) returns, a timeframe and the currency used. 
#' 
#' @slot xts_returns An xts of stock returns (potentially multiple stocks) 
#' @slot timeframe 
#' @slot currency Any three letter currency, or "Local" 
#' @include timeframe.R 
#' @export 
stock.returns <- setClass(
    Class = "stock.returns", 
    slots = c(xts_returns = "xts", timeframe = "timeframe", currency = "character"), 
    prototype = prototype(xts_returns = xts::xts(, order.by = c(lubridate::today())), timeframe = timeframe(), currency = "Local") 
) 

#' A stock.returns class is an xts of stock(s) returns, a timeframe and the currency used. 
#' 
#' @param timeframe 
#' @param benchmark_code The code for the index of stocks you want the returns for. 
#' @param portfolio_code The code for the portfolio of stocks you want the returns for. 
#' @param sec_id_list An explicit list of sec_id's you want the returns for. 
#' @param currency Any three letter currency, or "Local". The default is "AUD". 
#' @export 
stock.returns <- function(
    timeframe, benchmark_code, portfolio_code, sec_id_list, currency = "AUD") { 
     # ... code goes here ... 
} 

当我运行devtools::document自动生成我.Rd文件，为什么我会收到以下警告？

Warning: 
@slot [stock.returns.R#16]: requires name and description 
Warning: 
@param [stock.returns.R#28]: requires name and description 

Answer 1

记录的功能参数需要名称和说明。

在你的代码中，@slot timeframe和@param timeframe只有名字组成部分，他们需要一个描述太（就像所有其它参数）

这不会影响到/从建筑或安装停止包，但要获得CRAN上的软件包，您需要完成所有必需的参数和说明。