From ripley at stats.ox.ac.uk  Thu Sep  9 20:52:28 2004
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Thu Sep  9 20:52:32 2004
Subject: [Rd] man page of hist points to truehist, which can't be viewed
	without loading a library?
In-Reply-To: <85brgfiadc.fsf@servant.blindglobe.net>
Message-ID: <Pine.LNX.4.44.0409091946440.3233-100000@gannet.stats>

On Thu, 9 Sep 2004, A.J. Rossini wrote:

> 
> rdevel from yesterday, also in 1.9.1 (Debian, -3).
> 
> The man page of 'hist' (from the graphics package, obtained by
> "?hist") suggests 'truehist' under "see also", but 'truehist' isn't
> loaded by default (a sensible "of course"), so that "?truehist" fails.
> One can do help.search(), of course, which points what to do, but
> leads to my question:
> 
>   In referencing functions in other packages, should the "See Also"
>   link mention the library that they are coming from?  I'm less
>   concerned about the example and more concerned about some packages
>   I'm wrapping up.
> 
> (this was from the command line in a terminal window, not w/in ESS).

It is the norm: see e.g. format.Date.Rd or write.table.Rd, and a good 
idea.

-- 
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] man page of hist points to truehist, which can't be viewed without loading a library?
Prof Brian Ripley