View, List or Get R Source of Package Vignettes

View a specified package vignette, or list the available ones; display it rendered in a viewer, and get or edit its R source file.

vignette(topic, package = NULL, lib.loc = NULL, all = TRUE)

# S3 method for vignette print(x, …) # S3 method for vignette edit(name, …)


a character string giving the (base) name of the vignette to view. If omitted, all vignettes from all installed packages are listed.


a character vector with the names of packages to search through, or NULL in which ‘all’ packages (as defined by argument all) are searched.


a character vector of directory names of R libraries, or NULL. The default value of NULL corresponds to all libraries currently known.


logical; if TRUE search all available packages in the library trees specified by lib.loc, and if FALSE, search only attached packages.

x, name

object of class vignette.

ignored by the print method, passed on to file.edit by the edit method.


Function vignette returns an object of the same class, the print method opens a viewer for it. The program specified by the pdfviewer option is used for viewing PDF versions of vignettes. If several vignettes have PDF/HTML versions with base name identical to topic, the first one found is used.

If no topics are given, all available vignettes are listed. The corresponding information is returned in an object of class "packageIQR".

See Also

browseVignettes for an HTML-based vignette browser; RShowDoc(<basename>, package = "<pkg>") displays a “rendered” vignette (pdf or html).

  • vignette
  • edit.vignette
  • print.vignette
  • vignettes
library(utils) ## List vignettes from all *attached* packages vignette(all = FALSE) ## List vignettes from all *installed* packages (can take a long time!): vignette(all = TRUE) ## The grid intro vignette -- open it vignette("grid") # calling print() ## The same (conditional on existence of the vignettte). ## Note that 'package = *' is much faster in the case of many installed packages: if(!is.null(v1 <- vignette("grid", package="grid"))) { v1 # calling print(.) str(v1) ## Now let us have a closer look at the code <!-- %% print(utils:::getRcode(v1)) # the R file name --> <!-- %% if(interactive()) # "display" it --> <!-- %% --> <!-- %% ## or even more interactively: --> edit(v1) # e.g., to send lines ... }# if( has vignette "installed") ## A package can have more than one vignette (package grid has several): vignette(package = "grid") if(interactive()) { ## vignette("rotated") ## The same, but without searching for it: vignette("rotated", package = "grid") }
Documentation reproduced from package utils, version 3.4.1, License: Part of R 3.4.1

Community examples

Looks like there are no examples yet.