klutometis/roxygen — pull request #62 by cbeleites (2011-11-29 14:16:23+00:00)
Title: usage and alias for S4 methods

Dear all, I hope this patch may be of interest for roxygen2. It adds a first pieces of support for S4 methods.

- @usage didn't work for setMethod (NULL was returned) -> new test case in inst/tests/test-rd-usage.R
corresponding change in process.usage () in R/roclet-rd.R

- S4 method support in R/roclet-rd.R:
- create suitable usage tag structure (with signature and formals)
- create \S4method output
- an _additional_ S4 alias tag is created. I find for the majority of my S4 methods that they should have their own man page: a discussion of the behaviour of the method for specialized classes like hyperSpec is needed. With the fork page of the help system that allows users to reach the specialized help pages with just ?method without typing the exact signature.

- two first simple test cases in inst/tests/test-S4.R