From ripley at stats.ox.ac.uk  Tue Oct 12 19:47:14 2004
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Tue Oct 12 19:48:41 2004
Subject: [Rd] promptData still creates 'data(...)' in R 2.0.0
In-Reply-To: <52354.170.54.59.167.1097602754.squirrel@170.54.59.167>
Message-ID: <Pine.LNX.4.44.0410121842070.2375-100000@gannet.stats>

This is deliberate.

Datasets can only be used directly for packages to be installed with
`LazyData: Yes', and that is not known when prompt() is called.

Allowing direct use of datasets is a convenience that the avantgarde 
packages have adopted, but there can be good reasons not to go in the 
direction for individual packages (name clashes being one).

Some people have kept data(foo) in their documentation to allow their 
package to be still used with R 1.9.x (or even earlier).


On Tue, 12 Oct 2004 kwright@eskimo.com wrote:

> Not necessarily a bug report, but might be nice to change.
> 
> I'm using R 2.0.0 on Windows 2000.
> 
> The promptData function creates a .Rd file in which the 'usage' section is:
> 
> \usage{data(<dataset>)}
> 
> I've looked at several of the help files for various data sets.  It looks
> like the use of 'data' is being reduced and so it might be more
> appropriate for promptData to create this:
> 
> \useage{<dataset>}


-- 
Brian D. Ripley,                  ripley@stats.ox.ac.uk
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 272866 (PA)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595


[Rd] promptData still creates 'data(...)' in R 2.0.0
Prof Brian Ripley