Hi,

On Thursday 08 September 2011, meik michalke wrote:
> i would suggest using roxygen from here on, because it's harder to forget
> to update the docs if they're in the same file, and it automatically does
> some checking. i used Rd2roxygen to initially convert the existing docs.
> it's rather pointless to repeat that agein and again ;-)

yes, fully agreed. I was looking into how "roxygenization" would be added to 
our maintainance scripts, but while testing, I stumbled across some things 
that made me wonder. One thing is that rk.record.plot-docs apparently got 
missing in the conversion (I hope these were the only ones).

Another thing that I just noted is that the generated pages appear to lack a 
"usage" section, which is pretty confusing, esp. on pages listing multiple 
functions.

Also there may be some more subtle issues. For instance, on the roxygenized 
variant of the rk.misc-page, the "Details" for rk.rename.in.container() have 
moved into the "Description"-section for the whole page.

Is there anything we can do about those issues?
 
Regards
Thomas

Attachment: signature.asc
Description: This is a digitally signed message part.

------------------------------------------------------------------------------
Malware Security Report: Protecting Your Business, Customers, and the 
Bottom Line. Protect your business and customers by understanding the 
threat from malware and how it can impact your online business. 
http://www.accelacomm.com/jaw/sfnl/114/51427462/
_______________________________________________
RKWard-devel mailing list
RKWard-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/rkward-devel

Reply via email to