Re: [R] Function hints

From: hadley wickham <h.wickham_at_gmail.com>
Date: Tue 20 Jun 2006 - 23:04:17 EST

> what I really would love to see would be an improved help.search():
> on r-devel I found a reference to the /concept tag in .Rd files and the
> fact that it is rarely used (again: I was not aware of this :-( ...),
> which might serve as keyword container suitable for improving
> help.search() results. what about changing the syntax here to something like
> \concept {
> keyword = score,
> keyword = score
> ...
> }
> where score would be restricted to a small range of values (say, 1-3 or
> 1-5). if package maintainer then would choose a handful of sensible
> keywords (and scores) for a package and its functions one could expect
> improved search results. this might be a naive idea, but could a
> sort-by-relevance in the help.search() output profit from this?

This is not something I think you can solve automatically. Good keywording requries a lot of effort, and needs to be consistent to be useful. The only way to achieve consistency is to have only person keywording (difficult/expensive), or exhaustively document the process of keywording and then require all package authors to read and use (impossible).

Hadley



R-help@stat.math.ethz.ch mailing list
https://stat.ethz.ch/mailman/listinfo/r-help PLEASE do read the posting guide! http://www.R-project.org/posting-guide.html Received on Wed Jun 21 01:40:37 2006

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.1.8, at Wed 21 Jun 2006 - 02:14:00 EST.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-help. Please read the posting guide before posting to the list.