[Rd] R CMD build

Prof Brian D Ripley ripley@stats.ox.ac.uk
Wed, 5 Apr 2000 07:40:25 +0100 (BST)


On Wed, 5 Apr 2000, Kurt Hornik wrote:

> >>>>> Prof Brian D Ripley writes:
> 
> > On Wed, 29 Mar 2000, Paul Gilbert wrote:
> >> >Well, are there \alias entries in the Rd files?
> >> No. I guess that would be it. Should I have an empty \alias entry if the
> >> object does not have an alias, or should should I just live with the
> >> warnings?
> 
> > You should have an alias for each function documented there, even if
> > there is only one. The object name is itself an alias.  The \name
> > field is the help file name, not the object name (although 90+% of
> > them are the same), and it is the \alias's that gives the object
> > names,
> 
> (Not sure about the 90+ percent :-))

Last time I looked there were about 20 exceptions in the whole of base R,
out of ca 700 files.

> 
> >> >The convention is to put a \alias for the method in the help file for
> >> the generic.
> >> Ok, but I guess this won't work if the generic is the base and my method
> >> is in my library?
> 
> > Sure (and that is part of the debate). Either ignore them, or have a
> > .Rd with just a very brief description of these (e.g. just their
> > usages).
> 
> >> >> 4/ Checking for undocumented objects fails with an ERROR when
> >> checking
> >> >> an (undocumented) assignment object ( "input.series.names<-" ).
> >> >I think it works if you document it, though, and the error is correct,
> >> >surely?  Do you mean it gives ERROR and then stops rather than warns?
> >> 
> >> Yes, it should warn me about this, but it gives ERROR and stops. (If I
> >> run it with my makefile it returns code 1.) The message is:
> >> in eval(expr, envir, enclos) : couldn't find function
> >> "input.series.names<-"
> 
> > Looks like a bug, then.
> 
> Hmm.  Can you (Paul) perhaps give a small example I could reproduce?  I
> just tried the following:  let the R code contain 
> 
> 	"foo<-" <- function(x, value) NULL
> 
> Then if an Rd file has \alias{foo<-}, everything is o.k., if not,
> "foo<-" is shows as undoc object.  How do you get the error?

That (and "input.series.names<-") work for me on Solaris, too.


-- 
Brian D. Ripley,                  ripley@stats.ox.ac.uk
Professor of Applied Statistics,  http://www.stats.ox.ac.uk/~ripley/
University of Oxford,             Tel:  +44 1865 272861 (self)
1 South Parks Road,                     +44 1865 272860 (secr)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
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
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._