From thomas.petzoldt at tu-dresden.de  Sun Oct 18 22:45:13 2009
From: thomas.petzoldt at tu-dresden.de (Thomas Petzoldt)
Date: Sun, 18 Oct 2009 22:45:13 +0200
Subject: [Rd] linking to package directories broken in R >= 2.10 beta
In-Reply-To: <4ADB7A84.7020504@stats.uwo.ca>
References: <4AD9BB1E.5010408@TU-Dresden.de> <4AD9FA86.8050602@stats.uwo.ca>
	<4ADA058C.7070008@TU-Dresden.de> <4ADB7A84.7020504@stats.uwo.ca>
Message-ID: <4ADB7E59.1090708@tu-dresden.de>

Duncan Murdoch wrote:

[...]

> The doc directory is known to be visible.  It might surprise someone if 
> arbitrary directories were visible, and readable by any user.
> 
>> 2) The change will introduce additional work for package authors
>> that used internal links within their packages. I can, of course,
>> reorganize everything below doc, e.g. /library/foo/doc/examples ... but
>> this means that these things are even more hidden.
> 
> Why would someone know to look in .../examples?  Just update whatever 
> hint you gave them to look there, and tell them to look in 
> .../doc/examples instead.  I don't think it's likely that most people 
> would discover either directory without a hint somewhere.  If they were 
> looking for examples, they'd look in the documented places, the Examples 
> section of man pages, or in the vignettes.
> 
>> 3) However, according to the changed R-Exts, it was obviously decided
>> that this was necessary, so *I* will do the required reorganization.
> 
> I think it was not so much a decision that this was necessary, as that 
> it was prudent.
> 
> Duncan Murdoch

[...]

ok, I will agree, but let me add one final thought: What is with the 
/demo directory?

Thomas P.



[Rd] linking to package directories broken in R >= 2.10 beta
Thomas Petzoldt