Wrap \usage string and alias for S4 classes and methods

[eusebe]

Please consider this patch which should fix #21
and fix alias for S4 classes and methods (http://cran.r-project.org/doc/manuals/R-exts.html#Documenting-S4-classes-and-methods)

David

[eusebe]

I've just seen that there is a little bug with the first commit. For S3 method, the Rd file looks like:

\usage{
  \method{print}{foo}
(x, a = "sdmldsflkjmsqdlkfjk", b = "fmqlk", c = "\n\np. \n\n", ...)
}

There is a newline after \method, producing a warning with R CMD check. I've been looking and looking, but I can't see where this newline comes from...

[eusebe]

With the development version of roxygen, it seems that S4 classes and methods are not documented correctly. \alias{} should be of the form:
theclass-class
generic,signature_list-method

Consequently, my classes and methods appear not documented with R CMD check:

* checking for missing documentation entries ... WARNING
Undocumented S4 methods:
  generic 'print' and siglist 'Report'
  generic 'print' and siglist 'asciiCbind'
...

I tried to make a (possibly not very elegant) patch for this, is there a chance that it is considered for inclusion?

[hadley]

Could you please use str_c here?

[hadley]

Would you mind also including a few test cases?

[hadley]

Closing because I think the usage issue has been dealt with, and S4 needs deeper changes.