Re: [Rd] [R] Function hints

2006-06-20 Thread hadley wickham
> For me, it's been extremely helpful to keep function & documentation > together during editing-- it greatly increases the chance that I will > actually update the doco when I change the code, rather than putting it > off until I've forgotten what I did. Also, writing Rd format is a > nightmare (a

Re: [Rd] [R] Function hints

2006-06-20 Thread hadley wickham
I think it's bad to document dissimilar functions in the same file, but similar related functions *should* be documented together. Not doing this just adds to the burden of documenting them, and the risk of modifying only part of the documentation so that it is inconsistent. The user also gets th

Re: [Rd] [R] Function hints

2006-06-19 Thread Mark.Bravington
k Bravington CSIRO Mathematical & Information Sciences Marine Laboratory Castray Esplanade Hobart 7001 TAS ph (+61) 3 6232 5118 fax (+61) 3 6232 5012 mob (+61) 438 315 623 > -Original Message- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] On Behalf Of Duncan Mur

Re: [Rd] [R] Function hints

2006-06-19 Thread Duncan Murdoch
I've moved this from R-help to R-devel, where I think it is more appropriate, and interspersed comments below. On 6/19/2006 8:51 AM, hadley wickham wrote: > One of the recurring themes in the recent UserR conference was that > many people find it difficult to find the functions they need for a