From johannes_graumann at web.de Fri Feb 1 20:10:28 2013 From: johannes_graumann at web.de (Johannes Graumann) Date: Fri, 1 Feb 2013 22:10:28 +0300 Subject: [Roxygen-devel] Quo Vadis ROxygen? Message-ID: <201302012210.47917.johannes_graumann@web.de> Hi, I've been using roxygen2 for a while for documenting my amateurish enterprises and it has served me well. I have, however, expanded the arsenal recently into using S4 classes and this is where documentation using roxygen stops lending the helping hand it used to and using it becomes an excruciating "how do I have to convince roxygen to build documentation for my code" ball and chains ... I have been surfing around for alternatives, couldn't get the (old) s4 branch in github, roxygen3 doesn't seem a smooth ride either - I'm at a loss. Where do I go from here? Are there alternatives to roxygen? Is there a timeline for expanding toxygen(2)'s functionality into S$ space in a non- beta(alpha) manner? Where can novices pitch in? What is to grow into a future proof version (crystal ball, where art thou?) - roxygen3? I'd appreciate any input. Sincerely, Joh -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 836 bytes Desc: This is a digitally signed message part. URL: From h.wickham at gmail.com Mon Feb 4 21:45:58 2013 From: h.wickham at gmail.com (Hadley Wickham) Date: Mon, 4 Feb 2013 14:45:58 -0600 Subject: [Roxygen-devel] Quo Vadis ROxygen? In-Reply-To: <201302012210.47917.johannes_graumann@web.de> References: <201302012210.47917.johannes_graumann@web.de> Message-ID: Hi Joh, roxygen3 will eventually get merged back in to roxygen2 - I definitely plan to continue maintaining it, but other projects have priority at the moment. If you're having problems with roxygen3, it's probably namespace related - if you ping me and remind me, I can try and make a few minutes to investigate. If you want to pitch in, the roxygen3 design is fairly well developed and reasonably clean. You'll need a decent understanding of S4, and there's a bit of an intro in the readme (https://github.com/hadley/roxygen3) Hadley On Fri, Feb 1, 2013 at 1:10 PM, Johannes Graumann wrote: > Hi, > > I've been using roxygen2 for a while for documenting my amateurish > enterprises and it has served me well. > > I have, however, expanded the arsenal recently into using S4 classes and > this is where documentation using roxygen stops lending the helping hand it > used to and using it becomes an excruciating "how do I have to convince > roxygen to build documentation for my code" ball and chains ... > > I have been surfing around for alternatives, couldn't get the (old) s4 > branch in github, roxygen3 doesn't seem a smooth ride either - I'm at a > loss. > > Where do I go from here? Are there alternatives to roxygen? Is there a > timeline for expanding toxygen(2)'s functionality into S$ space in a non- > beta(alpha) manner? Where can novices pitch in? What is to grow into a > future proof version (crystal ball, where art thou?) - roxygen3? > > I'd appreciate any input. > > Sincerely, Joh > > _______________________________________________ > Roxygen-devel mailing list > Roxygen-devel at lists.r-forge.r-project.org > https://lists.r-forge.r-project.org/cgi-bin/mailman/listinfo/roxygen-devel -- Chief Scientist, RStudio http://had.co.nz/