Subject: Re: package description
From: Prof Brian Ripley (email@example.com)
Date: Tue 02 Nov 1999 - 02:44:37 EST
> Date: Mon, 01 Nov 1999 11:26:13 -0500
> From: Paul Gilbert <firstname.lastname@example.org>
> To: r-devel <email@example.com>
> Subject: package description
> It would be nice in the building of help for packages if there were some
> mechanism to provide a few paragraphs of general description for the
> package. (If this is already there I've missed it.) In the html help it
> would be possible to do this by looking for some special file (e.g.
> "General_Description") in the man directory and putting a link to that
> at the top of 00Index.html, but I don't now if this approach would work
> with other help formats.
It will not, not even for the html format as 00Index.html is
auto-generated by R INSTALL. There is nothing to prevent there being a
Rd file containing the description and some suitable \name or \alias
(package:foo, for example). This could be formalized, for example by a
special name (`Description') being placed first in the list.
That is my understanding of the purpose of library(help=foo) in the S
world, but it seems to be used rarely within R packages. That is, the
file INDEX could contain more than just the list of public functions.
-- Brian D. Ripley, firstname.lastname@example.org Professor of Applied Statistics, http://www.stats.ox.ac.uk/~ripley/ University of Oxford, Tel: +44 1865 272861 (self) 1 South Parks Road, +44 1865 272860 (secr) Oxford OX1 3TG, UK Fax: +44 1865 272595
-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.- r-devel mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html Send "info", "help", or "[un]subscribe" (in the "body", not the subject !) To: email@example.com _._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._
This archive was generated by hypermail 2b25 : Tue 04 Jan 2000 - 14:16:09 EST