[inlinedocs] A bug and a suggestion for S3 methods support

[Toby Dylan Hocking]

Hi, thanks for the helpful comments, and I'm glad to hear you like
using inlinedocs.

I was not able to reproduce the exact same error you had, but I see
what was happening, and I think I fixed it. The bugfix has been
checked in to SVN, rev 102, if you'd like to test it and make sure it
works on your end. 

Thanks for the insightful point about S3 methods. We have talked about
generating proper \method markup for S3 methods on the list before,
but I haven't got around to it yet since it doesn't generate a warning
in R CMD check. Keith wrote some support for setMethodS3()
definitions, but I don't really use it, so maybe Keith would have a
better idea of if it would be feasible anytime soon. It would be nice
if we could automatically detect methods and avoid having to write
something like ##<<method<<print<<object. In any case, if you manage
to write some code (maybe a new parser function?) that makes correct
S3 method markup for the usage section, please tell us about it.