Re: [Rd] Please explain your workflow from R code -> package -> R code -> package

From: steven mosher <>
Date: Sat, 10 Sep 2011 09:23:35 -0700

All I need now is a tool to go through the 4 packages I already created without Roxygen and spit out source files with the Roxygen comments in them...

really lazy.

On Fri, Sep 9, 2011 at 11:41 AM, Hadley Wickham <> wrote:
>> | In other languages, I've seen to write the documentation inside the
>> | code files and then post-process to make the documentation.  Is there
>> | a similar thing for R, to unify the R code development and
>> | documentation/package-making process?
>> You can also follow the cool kids who these days tie some of this together
>> using roxygen.
> It's not the cool kids who are doing this, it's the lazy kids ;)
> Roxygen(2) does remove a considerable amount of replication between
> code and documentation (e.g. replicating function usage in two
> places), and the close proximity between code and documentation does
> make it easier to remember to update your documentation when the code
> changes.
> Roxygen2 adds a few other tools for reducing duplication like
> templates, the ability to inherit parameter documentation from other
> function, and the family tag to automatically add seealso references
> between all members of a related family of functions.  These are
> things that are painful to do by hand and add a significance
> maintenance burden.
> I agree that there's no silver bullet, but good tools certainly can
> make life easier.
> Hadley
> --
> Assistant Professor / Dobelman Family Junior Chair
> Department of Statistics / Rice University
> ______________________________________________
> mailing list
> mailing list Received on Sat 10 Sep 2011 - 16:30:09 GMT

This quarter's messages: by month, or sorted: [ by date ] [ by thread ] [ by subject ] [ by author ]

All messages

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Sat 10 Sep 2011 - 16:50:28 GMT.

Mailing list information is available at Please read the posting guide before posting to the list.

list of date sections of archive