[Rd] Feature request: display file name in R CMD check warning

Duncan Murdoch murdoch.duncan at gmail.com
Thu Mar 17 10:36:54 CET 2011


On 16/03/2011 7:55 PM, Dan Tenenbaum wrote:
> Hi,
>
> I came across the following warning in R CMD check (it only occurred on
> Windows):
>
> The \usage entries for S3 methods should use the \method markup and not
>> their full name.
>> See the chapter 'Writing R documentation files' in manual 'Writing R
>> Extensions'.
>
>
> The package I'm looking at is one that I did not write which has 34 .Rd
> files. This warning does not tell me which file to look in. It would be very
> helpful if it did. Same goes for other warnings/errors produced by R CMD
> check.

I was unable to duplicate this.  When I tried it by messing up one of 
the man pages in the ellipse package, I got this:

S3 methods shown with full name in documentation object 'ellipse.glm':
   ellipse.glm

The \usage entries for S3 methods should use the \method markup and not
their full name.
See the chapter 'Writing R documentation files' in manual 'Writing R
Extensions'.

"Documentation object 'ellipse.glm'" tells me the \name{} inside the .Rd 
file, which is enough to uniquely identify the file.  Are you not seeing 
this part of the message?

Duncan Murdoch



More information about the R-devel mailing list