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