Re: [Rd] Help for methods

From: Duncan Murdoch <murdoch_at_stats.uwo.ca>
Date: Tue 19 Sep 2006 - 13:05:24 GMT

On 9/19/2006 8:52 AM, hadley wickham wrote:
>> You are supposed to do:
>>
>> ?summary.lm
>> ?summary.data.frame
>>
>> for S3 methods. The former works, the latter doesn't - which is
>> probably considered a bug, but then the usage of some of the
>> generics are probably considered obvious and fundamental enough
>> that summary.data.frame doesn't really behave in any substantially
>> different way compared to what is said in ?summary and ?Summary .

> 
> Well, I know that, and you know that, but how is anyone supposed to
> figure it out?  It means that you need to have a working knowledge of
> the S3 and S4 class systems before you can use the help to reliably
> get the documentation you need.

In the alpha of 2.4.0, both suggestions above work, as do ?summary and ?summary(data.frame()). ?summary(lm()) gives the same man page, rather than the summary.lm page (but the page does have a link to that page).

The problem with S3 methods is that it's pretty difficult for R to know that a particular object is an S3 generic. The only sign is that it has a call to UseMethod() in it. I think this is one of the motivations for S4.

Duncan Murdoch



R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Tue Sep 19 23:20:12 2006

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.1.8, at Tue 19 Sep 2006 - 14:30:10 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.