[R-pkg-devel] Note on winbuilder-develop

[Duncan Murdoch]

On 24/07/2019 3:08 a.m., Martin Maechler wrote:
>>>>>> Roy Mendelssohn
>>>>>>      on Tue, 23 Jul 2019 18:44:24 -0700 writes:
> 
>      > Thanks, I was looking at the raw files, not the .Rd files.
>      > There are \keyword arguments in those file, will have to
>      > search to see why they are getting generated.  -Roy
> 
> just to rub the obvious into everybody's face ;-) :-D
> { apology for any offence ! } :
> 
> If you'd use roxygen only initially and not anymore from then
> on, but rather then would keep hand-editing nicely humanly
> formatted  man/*.Rd  files,
> you would never see this (and quite a few "similar") problems.

I don't think that's a great idea, unless the initial use is basically 
no more than using prompt().  If you have comments in your source that 
look like help text, and different help text in your Rd file, it's going 
to lead to confusion.  I don't think Roxygen is capable of updating your 
source file comments when you edit your Rd file.

Duncan Murdoch