Roxygen
It is desirable that these tags and their syntax and semantics be compatible with those used by Doxygen and Javadoc, but extended with tags important for R specific things.
Doxygen, in particular, has some tags that are meaningless in R (@category and @protocol come to mind); wouldn't it be worthwhile, therefore, to start with a subset of Rd? Thinks like @name and @format could be gleaned from the code; and it seems like preserving other Rd names would uphold the "principle of least surprise."
Yes, actually I did not meant that you have to take the union of Javadoc and Doxygen keywords and try to fit it into R. Start with the things from R documentation, extend it with usefull R-specific keywords (like @export). And keep in mind that there may be users which use Doxygen and Javadoc and we want to uphold the "principle of least surprise". :-) Manuel.