check_pkg_docs {toscutil} | R Documentation |
Check Documented Functions in a Package
Description
Lists all documented functions in a package and checks their documentation elements for potential issues. The following checks are performed:
Title is present and doesn't start with regex "Function".
Description is present and doesn't start with "This function".
Value is present.
Example is present.
Usage
check_pkg_docs(pkg = NULL)
Arguments
pkg |
The package name. If NULL, the package name is inferred from the DESCRIPTION file in the current directory or any parent directory. If no DESCRIPTION file is found, the function stops with an error message. |
Value
Returns a dataframe with columns title
, description
, value
, examples
and rows corresponding to the documented functions in the package. Each cell contains a string describing the check result for the corresponding documentation element of that function.
Examples
df <- check_pkg_docs("tools")
try(df <- check_pkg_docs())