Re: [Rd] Creating package Vignette

From: Prof Brian Ripley <>
Date: Thu, 14 Jul 2011 17:32:41 +0100 (BST)

It depends what you mean by 'vignette': the R docs have been unclear (but R >= 2.13.0 are more consistent). In most cases a 'vignette' is an Sweave document, the vignette source being the .Rnw file, and the vignette PDF the processed .pdf file.

At present vignette() means Sweave documents, as only they have metadata like titles. This is planned to be changed soon.

On Thu, 14 Jul 2011, Nipesh Bajaj wrote:

> Hi all, I was trying to create some vignette files for my newly
> developed package, however wondering whether there could be any
> simpler way to do so. In writing R extension it is advised to go
> through Sweave route, however I have already got a big pdf file and
> want to use this as package vignette.
> So far I have manually created the inst/doc folder in the main package
> skeleton, and put that file into this, which is not working by calling
> "vignette(file_name)" after I build and load the package. I am

file_name is not an argument to vignette(): it is 'topic'. And topics are normally file basenames (without any extension), not file names.

> getting following error without opening that pdf file: "vignette
> 'file_name' *not* found"
> So I like to know, is there any way to use any arbitrary pdf file as
> vignette?

By definition, no.

> Any suggestion is highly appreciated.
> Thanks,
> ______________________________________________
> mailing list

Brian D. Ripley,        
Professor of Applied Statistics,
University of Oxford,             Tel:  +44 1865 272861 (self)
1 South Parks Road,                     +44 1865 272866 (PA)
Oxford OX1 3TG, UK                Fax:  +44 1865 272595

______________________________________________ mailing list
Received on Thu 14 Jul 2011 - 16:35: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 14 Jul 2011 - 17:20:08 GMT.

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

list of date sections of archive