R: Utilities for Building and Checking Add-on Packages

PkgUtils {utils} | R Documentation

## Utilities for Building and Checking Add-on Packages

### Description

Utilities for checking whether the sources of an R add-on package work correctly, and for building a source package from them.

### Usage

    R CMD check [options] pkgdirs
    R CMD build [options] pkgdirs

### Arguments

`pkgdirs` | a list of names of directories with sources of R add-on packages. For `check` these can also be the filenames of compressed `tar` archives with extension ‘.tar.gz’, ‘.tgz’, ‘.tar.bz2’ or ‘.tar.xz’ (where supported by `tar`).
`options` | further options to control the processing, or for obtaining information about usage and version of the utility.

### Details

`R CMD check` checks R add-on packages from their sources, performing a wide variety of diagnostic checks.

`R CMD build` builds R source tarballs. The name(s) of the packages are taken from the ‘DESCRIPTION’ files and not from the directory names. As from R 2.13.0 this works entirely on a copy of the supplied source directories.

Use `R CMD`

foo --help to obtain usage information on utility `foo`. The defaults for some of the options to `R CMD build` can be set by environment variables _R_BUILD_RESAVE_DATA_ and _R_BUILD_COMPACT_VIGNETTES_: see ‘Writing R Extensions’. Many of the checks in `R CMD check` can be turned off or on by environment variables: see Chapter 6 of the ‘R Internals’ manual. `R CMD build` uses the external `tar` program given by the TAR environment variable (which is set when R was configured on a Unix-alike). `R CMD check` by default unpacks tarballs by the internal `untar` function: if needed an external `tar` command can be specified by the environment variable R_INSTALL_TAR: please ensure that it can handle the type of compression used on the tarball. (This is sometimes needed for tarballs containing illegal or unsupported sections, and can be faster on very large tarballs. Setting R_INSTALL_TAR to tar.exe has been needed to overcome permissions issues on some Windows systems.)

### See Also

The sections on “Checking and building packages” and “Processing Rd format” in “Writing R Extensions” (see the ‘doc/manual’ subdirectory of the R source tree).

[Package utils version 2.15.1 Index]