undoc {tools} | R Documentation |
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.
undoc(package, dir, lib.loc = NULL)
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
to search for package . |
This function is useful for package maintainers mostly. In principle, all user level R objects should be documented; note however that the precise rules for documenting methods of generic functions are still under discussion.
An object of class "undoc"
which is a list of character vectors
containing the names of the undocumented objects split according to
documentation type. This representation is still experimental, and
might change in future versions.
There is a print
method for nicely displaying the information
contained in such objects.
undoc("tools") # Undocumented objects in 'tools'