From moshersteven at gmail.com  Sun Sep 11 00:33:44 2011
From: moshersteven at gmail.com (steven mosher)
Date: Sat, 10 Sep 2011 15:33:44 -0700
Subject: [Rd] Please explain your workflow from R code -> package -> R
 code -> package
In-Reply-To: <CAPPM_gSaWYBtownMCT_LcAQkCX-OWfWB7OkWG_Ww6RWDOR8f8w@mail.gmail.com>
References: <CAErODj_mu8dOujVCJh14d-UbDw9qrq-9CC3MeeCSQ6d28-rJDg@mail.gmail.com>
	<20074.20512.95925.44559@max.nulle.part>
	<CABdHhvE2amMC=DVr1tykkrnLZ3c5omSJPcHhoC9EuH4tpvXBWQ@mail.gmail.com>
	<CAFFLneTg2EuSL+fnLnhybwnvhxVBHyraiAMmLjCJ0rqvFXzwTQ@mail.gmail.com>
	<CAPPM_gSaWYBtownMCT_LcAQkCX-OWfWB7OkWG_Ww6RWDOR8f8w@mail.gmail.com>
Message-ID: <CAFFLneRW-gth3Hfyk3VKAtkz54hzgx4Oq2BHrucpFUvtRQD2cQ@mail.gmail.com>

Thanks, I was too lazy to even look for it.



On Sat, Sep 10, 2011 at 9:31 AM, Joshua Ulrich <josh.m.ulrich at gmail.com> wrote:
> On Sat, Sep 10, 2011 at 11:23 AM, steven mosher <moshersteven at gmail.com> wrote:
>> 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.
>>
>>
> That's what Rd2roxygen does...
>
> Best,
> --
> Joshua Ulrich ?| ?FOSS Trading: www.fosstrading.com
>
>
>
>>
>> On Fri, Sep 9, 2011 at 11:41 AM, Hadley Wickham <hadley at rice.edu> 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
>>> http://had.co.nz/
>>>
>>> ______________________________________________
>>> R-devel at r-project.org mailing list
>>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>>
>>
>> ______________________________________________
>> R-devel at r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>
>



[Rd] Please explain your workflow from R code -> package -> R code -> package
steven mosher