On 06/02/2013 9:49 AM, Hadley Wickham wrote:
>> I have heard of people using noweb to do this, but I can't point to any
>> examples. I'd actually recommend against it. Good documentation files
>> don't
>> make good source files.
>
> the compiler package in base R is, apparently, developed using noweb
> https://svn.r-project.org/R/trunk/src/library/compiler/noweb, which provide
> excellent documentation of the code for other developers and is not quite
> what Ivo was suggesting.
I'd argue that there's an important distinction between documenting a
function (how to use it) vs. documenting an algorithm (how it works).
I think noweb can work well for describing how something works, but
it's not so good for describing how to use it (as evidence see the 400
page latex package manuals that don't help you at all)
I agree about that.
Duncan Murdoch
______________________________________________
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.