Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Gabor Grothendieck
I find this very confusing too. I would also sometimes like to include pdf's that were not generated from Sweave and have them included in the package and listed in library(help = mypackage) output as well as with clickable links on the package's CRAN web page like vignettes are. On Thu, Jan 15,

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Perry de Valpine
Thanks for the helpful replies. Regarding the source: I see that in /grid/inst/doc there are no pdfs and no index.html, so that confirms that index.html is generated by the \VignetteIndexEntry method using Snw/Rnw when the grid package is built. That is helpful for me but not the main

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Simon Urbanek
On Jan 15, 2009, at 12:24 , Perry de Valpine wrote: I am looking at the 2.8.1 source code in R-2.8.1/src/library/grid/ inst/doc, where there is an index.html (I am not at daily syncing level and hope that is not an issue in this case). In this case the Snw files contain the %\VignetteIndexEntr

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Gabor Grothendieck
The source tree is at: https://svn.r-project.org/R/trunk and the src/library/grid subdirectory holds grid. To check out a copy using svn see the "svn checkout ..." command described here: http://developer.r-project.org/ On Thu, Jan 15, 2009 at 12:24 PM, Perry de Valpine wrote: > I am look

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Perry de Valpine
(Apologies for re-posting this from a few minutes ago. My message was scrubbed and I hope I've done it right now...) I am looking at the 2.8.1 source code in R-2.8.1/src/library/grid/ inst/doc, where there is an index.html (I am not at daily syncing level and hope that is not an issue in th

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Perry de Valpine
I am looking at the 2.8.1 source code in R-2.8.1/src/library/grid/ inst/doc, where there is an index.html (I am not at daily syncing level and hope that is not an issue in this case). In this case the Snw files contain the %\VignetteIndexEntry and associated commands, so the index.html coul

Re: [Rd] Documentation suggestions for vignettes

2009-01-15 Thread Gabor Grothendieck
On Wed, Jan 14, 2009 at 2:53 PM, Perry de Valpine wrote: > Dear R-devel, > > I am putting together a package vignette for the first time (R 2.8.1, > OS X) and had some bumps from section 1.4 ("Writing package > vignettes") of the "Writing R Extensions" document. Here are > suggestions to clean up

[Rd] Documentation suggestions for vignettes

2009-01-14 Thread Perry de Valpine
Dear R-devel, I am putting together a package vignette for the first time (R 2.8.1, OS X) and had some bumps from section 1.4 ("Writing package vignettes") of the "Writing R Extensions" document. Here are suggestions to clean up a few small documentation bugs (I think) and omissions. This is as