R - ROXYGEN2 "Error: titlerequires a value"

Question

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

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

kmmisc-package.R包含:

##' Miscellaneous Functions
##' 
##' tabular{ll}{
##' Package: tab kmmisccr
##' Type: tab Packagecr
##' Version: tab 0.1-2cr
##' Date: tab 2011-10-06cr    
##' License: tab GPL-2cr
##' LazyLoad: tab yescr
##' LazyData: tab yescr
##' }
##' 
##' @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 kmmisccr
#' Type: tab Packagecr
#' Version: tab 0.1-2cr
#' Date: tab 2011-09-14cr    
#' License: tab GPL-2cr
#' LazyLoad: tab yescr
#' LazyData: tab yescr
#' }
#' 
#' @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问题。在roxygen22.1中，带有连字符的#' @aliases a-b生成了Rd引用标签alias{"a-b"}。在这种情况下，代码没有问题，但在其他情况下需要一些注意。当然，如果您需要引号标记，您可以添加#' @aliases a-b。

所以我认为在这种情况下用#' @aliases kmmisc代替#' @aliases kmmisc package-kmmisc更好:

#' Miscellaneous Functions
#'
#' tabular{ll}{
#' Package: tab kmmisccr
#' Type: tab Packagecr
#' Version: tab 0.1-2cr
#' Date: tab 2011-09-14cr
#' License: tab GPL-2cr
#' LazyLoad: tab yescr
#' LazyData: tab yescr
#' }
#'
#' @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

尝试如下:

• 取消氧分表注释。(这可能是一个SO人工制品，但每个氧线应该以# '开始，即单个#)

• 对文档

进行以下更改

<>之前#' @name package-kmmisc#' @别名kmmisc包-kmmisc之前

换句话说:

• 修改@name
• 添加别名kmmisc

---

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