Re: [Rd] how to document stuff most users don't want to see

2009-10-06 Thread spencerg
I write *.Rd files primarily because it helps me think through what I want the software to do AND because the "\examples" provide any degree of unit testing I feel I need to create "trustworth software" (to quote Chambers). The fact that I can then share the resulting package with others is a

Re: [Rd] how to document stuff most users don't want to see

2009-10-06 Thread Seth Falcon
Writing good documentation is hard. I can appreciate the desire to find technological solutions that improve documentation. However, the benefit of a help system that allows for varying degrees of verbosity is very likely to be overshadowed by the additional complexity imposed on the help system.

[Rd] openNLP Segmentation Fault (PR#13986)

2009-10-06 Thread michael
Full_Name: Michael Olschimke Version: 2.9 OS: Ubuntu 8.04 TLS Submission from: (NULL) (188.96.220.32) When using openNLP (0.0-7) with rJava (0.7-0) with java-6-sun-1.6.0.07 on Ubuntu 8.04 TLS 32 bit I get the following error message (see below) when calling tagPOS. I have installed the packages a

Re: [Rd] Help file doesn't display correctly

2009-10-06 Thread Duncan Murdoch
On 10/6/2009 12:01 PM, Prof Brian Ripley wrote: On Tue, 6 Oct 2009, Ronggui Huang wrote: 2009/10/6 Prof Brian Ripley : On Tue, 6 Oct 2009, Ronggui Huang wrote: Dear R Developer, It seems to be a problem with help file. Not sure if it is related to the new format of Rd parser. Multiple lines

Re: [Rd] how to document stuff most users don't want to see

2009-10-06 Thread Sean O'Riordain
In some cases it would be nice to have a lot of examples explaining the different uses of different parameters instead of the more usual. I like the way in which log4j allows one to parameterise at runtime the verboseness of different parts of a runtime. So hypothetically (and assuming a lot!) on

Re: [Rd] Help file doesn't display correctly

2009-10-06 Thread Prof Brian Ripley
On Tue, 6 Oct 2009, Ronggui Huang wrote: 2009/10/6 Prof Brian Ripley : On Tue, 6 Oct 2009, Ronggui Huang wrote: Dear R Developer, It seems to be a problem with help file. Not sure if it is related to the new format of Rd parser. Multiple lines are joined together without proper line break.

Re: [Rd] Help file doesn't display correctly

2009-10-06 Thread Ronggui Huang
2009/10/6 Prof Brian Ripley : > On Tue, 6 Oct 2009, Ronggui Huang wrote: > >> Dear R Developer, >> >> It seems to be a problem with help file. Not sure if it is related to >> the new format of Rd parser. Multiple lines are joined together >> without proper line break. > > It was a problem with the

Re: [Rd] unit testing for R packages?

2009-10-06 Thread Shane Conway
On a related note: I recently started to set up CruiseControl ( http://cruisecontrol.sourceforge.net/) to do continuous integration with my R packages (along with my RUnit test cases). Has anyone had any luck with this before? I use it for other software and it provides a very nice interface... O

Re: [Rd] unit testing for R packages?

2009-10-06 Thread hadley wickham
> If you haven't done so already, you might want to read the RUnit Vignette: > http://cran.r-project.org/web/packages/RUnit/vignettes/RUnit.pdf. > On a somewhat related note: is anyone doing "continuous integration" with > their R packages?  I'm thinking about trying to use something like > CruiseC

Re: [Rd] Help file doesn't display correctly

2009-10-06 Thread Prof Brian Ripley
On Tue, 6 Oct 2009, Ronggui Huang wrote: Dear R Developer, It seems to be a problem with help file. Not sure if it is related to the new format of Rd parser. Multiple lines are joined together without proper line break. It was a problem with the handling of fancy quotes in a DBCS encoding (a

Re: [Rd] Help file doesn't display correctly

2009-10-06 Thread Duncan Murdoch
On 10/6/2009 5:12 AM, Ronggui Huang wrote: Dear R Developer, It seems to be a problem with help file. Not sure if it is related to the new format of Rd parser. Multiple lines are joined together without proper line break. Thanks, we're looking into it. Please try again in a day or two and let

[Rd] Help file doesn't display correctly

2009-10-06 Thread Ronggui Huang
Dear R Developer, It seems to be a problem with help file. Not sure if it is related to the new format of Rd parser. Multiple lines are joined together without proper line break. > ?mean There were 14 warnings (use warnings() to see them) ## All lines are joined together and not easy to read. >

Re: [Rd] str() gives odd looking output on complex vectors that are not purely imaginary (PR#13985)

2009-10-06 Thread maechler
> "RC" == Rich Calaway > on Tue, 6 Oct 2009 01:00:10 +0200 (CEST) writes: RC> Full_Name: Rich Calaway RC> Version: R 2.9.2 RC> OS: Windows Vista RC> Submission from: (NULL) (65.47.30.18) RC> Try this: RC> x <- rnorm(25) RC> y <- rnorm(25)*1i RC> z <

Re: [Rd] how to document stuff most users don't want to see

2009-10-06 Thread Patrick Burns
I think the problem is more subtle than Spencer implies. It is good to have as much documentation as possible. However, if a help file is long and complex, then people get intimidated and don't read it at all. It would be nice to have a feature so that help files can be displayed with different

Re: [Rd] unit testing for R packages?

2009-10-06 Thread Shane Conway
If you haven't done so already, you might want to read the RUnit Vignette: http://cran.r-project.org/web/packages/RUnit/vignettes/RUnit.pdf. On a somewhat related note: is anyone doing "continuous integration" with their R packages? I'm thinking about trying to use something like CruiseControl (wh