a nice aspect about roxygen (and perl pod) is that it compiles into the standard .Rd files. it's not a substitute, but a complement tool. it may also make a good start for docs when one starts writing code, and be eventually yanked out in favor of direct changes in the .Rd files that it has created.
it may or may not be for code which is destined to become a real package for third parties. for end users like me, it is about documenting their own basic code to the point that they themselves still understand it a year later. in a sense, roxygen comments (or perl podl) are more lightweight than .Rd and more heavyweight than just '#' comments. /iaw ---- Ivo Welch (ivo.we...@gmail.com) ______________________________________________ R-help@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-help PLEASE do read the posting guide http://www.R-project.org/posting-guide.html and provide commented, minimal, self-contained, reproducible code.