[Rd] comment() and ls() / ls.str()

2007-08-30 Thread François Pinard
Hi, people. After I revisited some older .RData files this evening, I came to consider that comment() might not be such a bad idea, after all! :-) However, if I randomly visit such older files, it is unlikely that I remember which objects got a comment attribute and which do not. It would be n

[Rd] R 2.5.1 scheduled for October 3

2007-08-30 Thread Peter Dalgaard
This is to announce that we plan to release R version 2.6.0 on Wednesday October 3, 2007. The following information is mainly for developers, package maintainers and repository maintainers. The planned procedure is Sep 5: "Grand Feature" Freeze 2.6.0 alpha Sep 19: Feature Freeze 2.6.0

Re: [Rd] suggesting \alias* for Rd files (in particular for S4 method documentation)

2007-08-30 Thread Oleg Sklyar
Maybe I need to add a comment. The idea is not to avoid providing documentation for specific methods, rather to be able to selectively hide things in the index keeping the index sane. On the developer discretion, as generally I think the developer should decide what the user can see and how. It w

Re: [Rd] suggesting \alias* for Rd files (in particular for S4 method documentation)

2007-08-30 Thread Henrik Bengtsson
On 8/30/07, James W. MacDonald <[EMAIL PROTECTED]> wrote: > I think Oleg makes a good point here, and I don't see how his suggestion > would hide any documentation. > > As an example, start R and then open the HTML help page, and go to the > Category package. If you click on any one of > > annotati

Re: [Rd] R CMD check recursive copy of tests/

2007-08-30 Thread Henrik Bengtsson
Hi. On 8/30/07, Martin Maechler <[EMAIL PROTECTED]> wrote: > > "HenrikB" == Henrik Bengtsson <[EMAIL PROTECTED]> > > on Wed, 29 Aug 2007 15:11:17 -0700 writes: > > >> From NEWS of R v2.6.0 devel: > HenrikB> o R CMD check now does a recursive copy on the > HenrikB> 'tests'

Re: [Rd] suggesting \alias* for Rd files (in particular for S4 method documentation)

2007-08-30 Thread James W. MacDonald
I think Oleg makes a good point here, and I don't see how his suggestion would hide any documentation. As an example, start R and then open the HTML help page, and go to the Category package. If you click on any one of annotation,GOHyperGParams-method categoryName,GOHyperGParams-method conditio

Re: [Rd] suggesting \alias* for Rd files (in particular for S4 method documentation)

2007-08-30 Thread Martin Morgan
Hi Oleg -- On the usefulness of write.image,Image,character-method, in the end I really want documentation on specific methods. Maybe the issue is one of presentation? write.image Image,character-method Image,missing-method or, in a little more dynamic world, a '+' in front of write.imag

[Rd] suggesting \alias* for Rd files (in particular for S4 method documentation)

2007-08-30 Thread Oleg Sklyar
Hi, I do not know if everybody finds index pages of the html-formatted R help useful, but I know I am at least not the only one who uses them extensively to get the overview of functions and methods in a package (even for my own package). Problems arise, however, if a lot of S4 methods need to be

Re: [Rd] R CMD check recursive copy of tests/

2007-08-30 Thread Martin Maechler
> "HenrikB" == Henrik Bengtsson <[EMAIL PROTECTED]> > on Wed, 29 Aug 2007 15:11:17 -0700 writes: >> From NEWS of R v2.6.0 devel: HenrikB> o R CMD check now does a recursive copy on the HenrikB> 'tests' directory. HenrikB> However, R CMD check does not run *.R scripts