roxygen2“错误:标题需要一个值”

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和刚刚从CRAN重新安装的roxygen2 2.1。完整的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 problem。在roxygen2 2.1中，带有连字符的#' @aliases a-b生成Rd引用标记\alias{"a-b"}。在这种情况下，代码没有问题，但在其他情况下，需要注意。当然，如果需要带引号的标记，可以添加#' @aliases a-b。

因此，我认为在这种情况下，最好用#' @aliases kmmisc替换#' @aliases kmmisc package-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