Re: [Rd] Vignette questions

From: beleites,claudia <>
Date: Thu, 12 Apr 2012 00:23:16 +0200

Very quick & short answer:

I made the transition to ./vignettes for hyperSpec (you can look at the source at r-forge) - it was a mess. It is almost working now (compression is missing, I'll have to figure out how to invoke ghostscript in an OS idependent way, qpdf doesn't give me the compression rates).

I have .pdf is under version control only for those vignettes that I build externally (with the fake .Rnws that produce the proper indexing as vignette). They are all (regardless whether BUILD and check affect them or not) in ./vignettes. I think that strategy can at least partially solve the issue with non-Sweave vignettes as well as long as the result is a pdf. You may need to play with ./vignettes/.install_extras if additional, non pdf and non Rnw files are needed.



Von: [] im Auftrag von Yihui Xie [] Gesendet: Mittwoch, 11. April 2012 23:28 An: Terry Therneau
Betreff: Re: [Rd] Vignette questions

For 1, you should run R CMD check on the tar ball (pkg_x.x.tar.gz) from R CMD build instead of the source directory. R CMD build will build the PDF vignette into the tar ball.

For 2, I have been confused by ./vignettes vs ./inst/doc since ./vignettes was introduced. I might be able to figure it out by try-and-err but I never tried, and I'm still sticking to ./inst/doc. At least you can exclude the Rnw source in .Rbuildignore so that R can only stare at your PDF documents and sigh.

For 3, I remember some of us requested that R could also respect entries of non-Sweave vignettes (like the ones in ./demo/00Index), but this is not possible as far as I know. However, I can tell you a dark voodoo seems to be still working: you can write your own index.html under ./inst/doc with your own links to vignettes.


Yihui Xie <>
Phone: 515-294-2465 Web:
Department of Statistics, Iowa State University
2215 Snedecor Hall, Ames, IA

On Wed, Apr 11, 2012 at 3:41 PM, Terry Therneau <> wrote:

> Context: R2.15-0 on Ubuntu.
> 1. I get a WARNING from CMD check for "Package vignette(s) without
> corresponding PDF:
> In this case the vignettes directory had both the pdf and Rnw; do I need to
> move the pdf to inst/doc?
> I'm reluctant to add the pdf to the svn source on Rforge, per the usual
> rule that a code management system should not have both a primary source and
> a object dervived from it under version control. However, if this is the
> suggested norm I could do so.
> 2. Close reading of the paragraph about vignette sources shows the following
> -- I think? If I have a vignette that should not be rebuilt by "check" or
> "BUILD" I should put the .Rnw source and pdf in /inst/doc, and have the
> others that should be rebuilt in /vignettes. This would include any that
> use "private R packages, screen snapshots, ...", or in my case one that
> takes just a little short of forever to run.
> 3. Do these unprocessed package also contribute to the index via
> \VignetteIndexEntry lines, or will I need to create a custom index?
> Terry Therneau
> ______________________________________________
> mailing list
______________________________________________ mailing list ______________________________________________ mailing list
Received on Wed 11 Apr 2012 - 22:22:23 GMT

This quarter's messages: by month, or sorted: [ by date ] [ by thread ] [ by subject ] [ by author ]

All messages

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 Thu 12 Apr 2012 - 12:30:45 GMT.

Mailing list information is available at Please read the posting guide before posting to the list.

list of date sections of archive