roxygen2 "Error: titlerequires a value"

Question

Recibo un error de roxygenize() que no puedo entender. Tengo un paquete de mis funciones misceláneas en el que los archivos .Rd se generan a través de roxygen. El error es Error: titlerequires a value, que sugiere que no hay @title etiqueta. Sin embargo, hay una etiqueta @title en el archivo kmmisc-package.R, por lo que no estoy seguro de cuál es el problema.

kmmisc-package.R contiene:

##' 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 

estoy usando R 2.13.2 con roxygen2 2.1 acaba de instalar desde CRAN. La completa sessionInfo() es en lo esencial en https://gist.github.com/1268056

Editar

A sugerencia de @ Andrie, ahora tengo

#' 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 

que se sigue generando el mismo error.

Answer 1

No pude replicar el error de su primer código ... ¿Está recibiendo el mismo mensaje de error de roxygenize() al siguiente ejemplo simple?

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

---

una información adicional:

El código por @Andrie, #' @aliases kmmisc package-kmmisc, tiene una @aliases problem. En roxygen2 2.1, #' @aliases a-b, que tiene un guión, genera la etiqueta entrecomillada Rd \alias{"a-b"}. En este caso, el código no tiene ningún problema, pero en otro caso requiere un poco de atención. Por supuesto, si necesita etiquetas citadas, agregue #' @aliases a-b.

Así que creo que es mejor sustituir #' @aliases kmmisc package-kmmisc con #' @aliases kmmisc en este caso:

#' 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

intente lo siguiente:

• Descomente sus declaraciones roxygen. (Esto podría ser un SO artefacto, pero cada línea roxygen debe comenzar con # ', es decir, una sola #)

• Realiza los siguientes cambios en la documentación

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

En otras palabras:

• Cambiar el valor de @name
• Añadir un alias llamado kmmisc

---

Estas son las únicas diferencias entre su ejemplo y mi propio paquete de documentación.