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] 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