[Rd] R CMD build/check

[Paul Gilbert]

Let me start out by saying that after using "R CMD build" for a few days
it appears to be a truely wonderful facility, even if I didn't really
want to know about all the problems with my packages right now.

>Please try to eliminate all problems reported by the R package builder
>before submitting a package to CRAN.

Now here are a few caveates. Please let me know if  I'm not aware of
something that has already been fixed.

1/ I'm using a file 00General_Description.Rd to provide a general
description of the package. This gets reported as an Rd file without
alias, but even though the package builder reports that as a problem I
didn't intend to eliminate it.

2/ Specific methods get reported as undocumented functions unless the
generic documentation has an alias line for the specific method. This is
not a problem when everything is in one package, however, for many of my
specific methods  the generic method is in another of my packages or in
the base. (This can generate a lot of warning, which obscure more
important warnings.) I'm putting a "stub" description in to eliminate
all the warnings, but I'm not sure if this is the ideal way to do this.

3/ Data sets cannot use constructors in the package. They need to be
structures which can be fully recognized by the base system. (.rda files
may be a better alternative in this case?)

4/ R CMD build does not work for bundles, but it can be used to test
sub-packages and then the bundle rolled up afterwards directly with tar
and gzip. (This is not difficult and not a problem, but people should be
aware of it.)

Paul Gilbert

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
r-devel mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html
Send "info", "help", or "[un]subscribe"
(in the "body", not the subject !)  To: r-devel-request@stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._