undoc

0th

Percentile

Find Undocumented Objects

Finds the objects in a package which are undocumented, in the sense that they are visible to the user (or data objects or S4 classes provided by the package), but no documentation entry exists.

Keywords
documentation
Usage
undoc(package, dir, lib.loc = NULL)
Arguments
package

a character string naming an installed package.

dir

a character string specifying the path to a package's root source directory. This must contain the subdirectory man with R documentation sources (in Rd format), and at least one of the R or data subdirectories with R code or data objects, respectively.

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.

Details

This function is useful for package maintainers mostly. In principle, all user-level R objects should be documented.

The base package is special as it contains the primitives and these do not have definitions available at code level. We provide equivalent closures in environments .ArgsEnv and .GenericArgsEnv in the base package that are used for various purposes: undoc("base") checks that all the primitives that are not language constructs are prototyped in those environments and no others are.

Value

An object of class "undoc" which is a list of character vectors containing the names of the undocumented objects split according to documentation type.

There is a print method for nicely displaying the information contained in such objects.

See Also

codoc, QC

Aliases
  • undoc
  • print.undoc
Examples
library(tools) # NOT RUN { undoc("tools") # Undocumented objects in 'tools' # }
Documentation reproduced from package tools, version 3.5.0, License: Part of R 3.5.0

Community examples

Looks like there are no examples yet.