checkVignettes

0th

Percentile

Check Package Vignettes

Check all Sweave files of a package by running Sweave and/or Stangle on them. All R source code files found after the tangling step are sourceed to check whether all code can be executed without errors.

Keywords
utilities, documentation
Usage
checkVignettes(package, dir, lib.loc = NULL, tangle = TRUE, weave = TRUE, latex = FALSE, workdir = c("tmp", "src", "cur"), keepfiles = FALSE)
Arguments
package
a character string naming an installed package. If given, Sweave files are searched in subdirectory ‘doc’.
dir
a character string specifying the path to a package's root source directory. This subdirectory ‘inst/doc’ is searched for Sweave files.
lib.loc
a character vector of directory names of R libraries, or NULL. The default value of NULL corresponds to all libraries currently known. The specified library trees are used to search for package.
tangle
Perform a tangle and source the extracted code?
weave
Perform a weave?
latex
logical: if weave and latex are TRUE and there is no ‘Makefile’ in the vignettes directory, run the weaved files through pdflatex.
workdir
Directory used as working directory while checking the vignettes. If "tmp" then a temporary directory is created, this is the default. If "src" then the directory containing the vignettes itself is used, if "cur" then the current working directory of R is used.
keepfiles
Delete files in the temporary directory? This option is ignored when workdir != "tmp".
Details

A ‘vignette’ is a file in the package's ‘inst/doc’ directory with extension ‘.Rnw’ (preferred), ‘.Snw’, ‘.Rtex’ or ‘.Stex’ (and lower-case versions are also accepted).

If tangle is true, this function runs Stangle to produce (one or more) R code files from each vignette, then sources each code file in turn.

If weave is true, the vignettes are run through Sweave, which will produce a ‘.tex’ file for each vignette. If latex is also true, texi2pdf is run on the ‘.tex’ files from those vignettes which did not give errors in the previous steps.

Value

An object of class "checkVignettes", which is a list with the error messages found during the tangle, source, weave and latex steps. There is a print method for displaying the information contained in such objects.

Aliases
  • checkVignettes
  • print.checkVignettes
Documentation reproduced from package tools, version 3.1.0, License: Part of R 3.1.0

Community examples

Looks like there are no examples yet.