[Roxygen-devel] [roxygen2] roxygenise, setGeneric and .svn directory

[Yihui Xie]

I don't remember there was a tag named @rdfile; at least in roxygen2
it is @rdname.

I guess @rdname is not very often used, so a little bit manual
tweaking to the auto-generated roxygen comments should not be too
hard. Anyway, I will be glad to include support for @rdname in
Rd2roxygen when I'm free.

BTW, as Hadley said, it is painful to maintain documentation partly by
Rd and partly by roxygen. I really wonder this rationale.

Regards,
Yihui
--
Yihui Xie <xieyihui at gmail.com>
Phone: 515-294-2465 Web: http://yihui.name
Department of Statistics, Iowa State University
2215 Snedecor Hall, Ames, IA



On Mon, Aug 15, 2011 at 10:25 AM, Hadley Wickham <hadley at rice.edu> wrote:
>>> I was not roxigenising in place because I had some manually made Rd
>>> files in the man directory, and didn't want to overwrite them.
>>
>> I can second this rationale.
>
> So then you manually copy across the new files into the existing
> directory?  Sounds painful!
>
>> The addition of the @rdfile tag in roxygen2 has largely removed my need
>> to run roxygen in a different directory, as have improvements like the
>> rd2roxygen package
>
> How are you using rd2roxygen?  That seems like something you'd only
> need to run once.
>
>> (is this compatible with roxygen2, specifically
>> including @rdfile tag reverse parsing from alias directives in Rd
>> files?)
>
> It might not be - I've cc'd the maintainer so hopefully he'll be
> encouraged to submit a update ;)
>
>> One feature that I miss from roxygen is 'R CMD roxygen'.  It was nice to
>>
>> R CMD roxygen pkgname
>> R CMD check pkgname
>> R CMD build pkgname
>
> I've moved to doing everything in R:
>
> library(devtools)
> document("pkgname")
> check("pkgname")
> build("pkgname")
> release("pkgname") # uploads to cran for you & sends Kurt an email
>
> Hadley
>
> --
> Assistant Professor / Dobelman Family Junior Chair
> Department of Statistics / Rice University
> http://had.co.nz/
>