Re: [Rd] Links to non-vignette documentation

From: hadley wickham <h.wickham_at_gmail.com>
Date: Fri 24 Feb 2006 - 14:29:25 GMT

> No, there's no automatic building after the promptPackage call. It's up
> to you to decide which functions need to be mentioned to users. In
> large packages it usually doesn't make sense to list all the functions,
> so the package writer needs to use judgement here. There are other
> mechanisms (e.g. ls("package:XXX") for a list of names, the help index
> generation for a list of names and titles) to get a list of everything.

Ok, that seems reasonable, but perhaps promptPackage (or documentation) could make this more clear.

> There aren't any immediate plans to change help(package=XXX), but I
> think in the long run, if package?XXX receives wider support than it has
> now, it would make sense to make that change.

When was this form of package documentation created? How are users supposed to know it exists? I couldn't find any pointers to it from ?help, ?library or from help(package=XXX).

Hadley



R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Sat Feb 25 01:51:38 2006

This archive was generated by hypermail 2.1.8 : Sat 25 Feb 2006 - 10:15:53 GMT