roxygen2“错误：title需要一个值”

Question

我收到了roxygenize()的错误，我无法理解。 我有一个我的杂项函数包，其中.Rd文件是通过roxygen生成的。

错误是Error: titlerequires a value ，这表明没有@title标记。 但是kmmisc-package.R文件中有一个@title标签，所以我不确定是什么问题。

kmmisc-package.R包含：

##' Miscellaneous Functions
##' 
##' \tabular{ll}{
##' Package: \tab kmmisc\cr
##' Type: \tab Package\cr
##' Version: \tab 0.1-2\cr
##' Date: \tab 2011-10-06\cr    
##' License: \tab GPL-2\cr
##' LazyLoad: \tab yes\cr
##' LazyData: \tab yes\cr
##' }
##' 
##' @author Me \email{my@@email}
##' 
##' Maintainer: Me \email{my@@email}
##'
##' @name kmmisc-package
##' @docType package
##' @title KM Misc
##' @keywords package
##' 
NULL

我正在使用R 2.13.2与roxygen2 2.1刚从CRAN重新安装。 完整的sessionInfo()位于https://gist.github.com/1268056的要点中

编辑

在@ andrie的建议下，我现在有了

#' Miscellaneous Functions
#' 
#' \tabular{ll}{
#' Package: \tab kmmisc\cr
#' Type: \tab Package\cr
#' Version: \tab 0.1-2\cr
#' Date: \tab 2011-09-14\cr    
#' License: \tab GPL-2\cr
#' LazyLoad: \tab yes\cr
#' LazyData: \tab yes\cr
#' }
#' 
#' @author Me \email{my@@email}
#' 
#' Maintainer: Me \email{my@@email}
#' @name package-kmmisc
#' @docType package
#' @title KM Misc
#' @keywords package
#' @aliases kmmisc package-kmmisc
#'
#' 
NULL

这仍然会产生相同的错误。

Answer 1

我无法从您的第一个代码复制错误...您是否从roxygenize()收到相同的错误消息到以下简单示例？

#' A test function
#'
#' Description
#'
#' Details
#'
#' @param x numeric number
f1 <- function(x) {
  x
}

---

附加信息 ：

@Andrie的代码， #' @aliases kmmisc package-kmmisc ，有@aliases问题 。 在roxygen2 2.1中， #' @aliases ab （带有连字符）生成Rd引用标记\\alias{"ab"} 。 在这种情况下，代码没有问题，但在其他情况下需要一些注意。 当然，如果你需要带引号的标签，你可以添加#' @aliases ab 。

所以我认为在这种情况下用#' @aliases kmmisc替换#' @aliases kmmisc package-kmmisc #' @aliases kmmisc ：

#' Miscellaneous Functions
#'
#' \tabular{ll}{
#' Package: \tab kmmisc\cr
#' Type: \tab Package\cr
#' Version: \tab 0.1-2\cr
#' Date: \tab 2011-09-14\cr
#' License: \tab GPL-2\cr
#' LazyLoad: \tab yes\cr
#' LazyData: \tab yes\cr
#' }
#'
#' @author Me \email{my@@email}
#'
#' Maintainer: Me \email{my@@email}
#' @name package-kmmisc
#' @aliases kmmisc
#' @docType package
#' @title KM Misc
#' @keywords package
NULL

Answer 2

请尝试以下方法：

• 取消注释你的roxygen语句。 （这可能是一个SO工艺品，但每条roxygen线应该以# '开头，即一个# ）

• 对文档进行以下更改

#' @name package-kmmisc
    #' @aliases kmmisc package-kmmisc

换一种说法：

• 更改@name的值
• 添加名为kmmisc的别名

---

这些是您的示例和我自己的包文档之间的唯一区别。