On 18/10/2009 4:45 PM, Thomas Petzoldt wrote:
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?

It's not displayed by the help system, it is displayed by the demo() function. There wasn't a way to get to it through the help system in previous versions, was there? (If you were running a browser you could browse files on the local file system, and you could construct a \url{} in a man page, but I don't think there were any links to the demo directory generated by R, were there?)

Duncan Murdoch

______________________________________________
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel

Reply via email to