PkgUtils {utils} | R Documentation |
Utilities for checking whether the sources of an R add-on package work correctly, and for building a source package from them.
R CMD check [options] pkgdirs R CMD build [options] pkgdirs
pkgdirs |
a list of names of directories with sources of R
add-on packages. For |
options |
further options to control the processing, or for obtaining information about usage and version of the utility. |
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
.
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.)
They make use of a temporary directory specified by the environment
variable TMPDIR
and defaulting to c:/TEMP. Do ensure
that if set forward slashes are used.
The sections on “Checking and building packages” and “Processing Rd format” in “Writing R Extensions” (see the Manuals sub-menu of the Help menu on the console).