[Rd] Help for methods

[hadley wickham]

>  I think the spirit of Hadley's request could be handled by introducing a
> declaration for S3 methods and by inserting S4-style alias{} lines into
> their documentation.  For example, if a function, say
> setOldGeneric("summary"),  similar to setOldClass, informed the system that
> "summary" was an S3 generic, then having an alias for "summary.lm-method" in
> the summary.lm.Rd file would allow a consistent set of documentation tools
> to work on those S3 methods and on S4 methods.

That seems like a really nice idea.  I'd imagine that a lot of the
setOldGeneric methods could be added automatically by looking for
functions of the form function(x, ...) UseMethod("...", x) - any that
were missed could then be added by hand.

Hadley