Re: [Rd] vignette compilation times

From: Berwin A Turlach <berwin_at_maths.uwa.edu.au>
Date: Sat, 21 Feb 2009 02:37:38 +0800

G'day Gabor,

On Thu, 19 Feb 2009 17:47:53 -0500
Gabor Grothendieck <ggrothendieck_at_gmail.com> wrote:

> [...]
> Unless this has changed recently,I've tried including a PDF but it
> does not appear in library(help = myPackage) nor on the CRAN site on
> http://cran.r-project.org/package=myPackage
> while Sweave'd PDFs do.

If you want a PDF file to appear in library(help=myPackage), then you can write a vignette that just includes that PDF file via \includepdf from the LaTeX package(?) pdfpages.

You will, of course, end up with two PDF files that are practically identical. So you might want to exclude the original PDF file from the build package via .Rbuildignore.

If you do so, the next problem is that since R 2.6.0 "R CMD check" is trying to latex the vignette and not just checks the code in the vignette. And in current TeX systems latex will hang if \includepdf does not find the specified PDF file; latex does not stop with an error, it hangs.

So the vignette has to be written smart enough to try to include the PDF file via \includepdf only if the file really exists, but that can easily be done. See the package lasso2 for an example.

If you follow this set up, your PDF file will show up in library(help=myPackage) and your package will pass "R CMD check" on CRAN. HTH. Cheers,         

        Berwin



R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Fri 20 Feb 2009 - 17:47:51 GMT

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Sat 21 Feb 2009 - 07:30:33 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.

list of date sections of archive