[Roxygen-devel] DESCRIPTION file generation + roxygen() error + multiple keywords

[Vinh Nguyen]

Dear list,

I'm new to creating R packages and am jumping right into roxygen as it
allows for the documentation part of package creation easier.  Some
questions:

1.  I'm following the vignette of roxygen.  For the package
documentation, packagename-package.R(d), does nothing from this chunk
get transcribed into the DESCRIPTION file at all?  Example:

#' Tests pseudoprimality by Fermat's little theorem.
#'
#' \tabular{ll}{
#' Package: \tab pseudoprime\cr
#' Type: \tab Package\cr
#' Version: \tab 0.1\cr
#' Date: \tab 2008-08-24\cr
#' License: \tab GPL (>= 2)\cr
#' LazyLoad: \tab yes\cr
#' }
#'
#' Using the Fermat primality test, pseudoprime checks for primes
#' probabilistically; the test is fooled every time by Carmichael
#' numbers.
#'
#' \code{\link{is.pseudoprime}} checks a number \code{n} for
#' pseudoprimality, applying Fermat's test \code{times} times.
#'
#' @name pseudoprime-package
#' @aliases pseudoprime
#' @docType package
#' @title Tests pseudoprimality by Fermat's little theorem
#' @author Peter Danenberg \email{pcd@@roxygen.org}
#' @references
#' \url{http://en.wikipedia.org/wiki/Fermat's_little_theorem}
#' @keywords package
#' @seealso \code{\link{is.pseudoprime}}
#' @examples
#' is.pseudoprime(13, 4)
roxygen()

The tabular part seems to go into a DESCRIPTION file.  Is there a way
(or plans) to update the DESCRIPTION file based on this chunk?  Am I
missing something?  I think having this piece of information in one
place as opposed to two is easier on the maintainer.

2.  I get an error saying roxygen() is not found when running R CMD
check after roxygenize().  Should we always specify that our package
depends on roxygen in order for it to pass this?  roxygen() is in the
.R file after running package.skeleton() and roxygenize().

3  How should multiple keywords be spelled out in the documentation
chunk?  Commas didn't work for me.  One word per @keywords tag?

Thanks so much!

Vinh
--
Vinh Nguyen
Department of Statistics
Donald Bren School of ICS
2231 Bren Hall
University of California, Irvine
Irvine, CA 92607
vqnguyen at uci.edu | http://www.ics.uci.edu/~vqnguyen/
Schedule a meeting: http://tungle.me/VinhNguyen