Rdpack (version 0.4-20)

compare_usage1: Compare usage entries for a function

Description

Compare usage entries for a function.

Usage

compare_usage1(urdo, ucur)

Arguments

urdo
usage text for a function or S3 method from an Rd object or file.
ucur
usage generated from the actual object.

Value

TRUE if the usages are identical, FALSE otherwise. The return value has attribute "details", which is a list providing details of the comparison. The elements of this list should be referred by name, since if one of urdo or ucur is NULL or NA, the list contains only the fields "obj_removed", "obj_added", "rdo_usage", "cur_usage", and "alias".

Details

Compares the usage statements for functions in the Rd object or file urdo to the usage inferred from the actual definitions of the functions. The comparison is symmetric but the interpretation assumes that ucur may be more recent.

Note: do not compare the return value to TRUE with identical or isTRUE. The attribute makes the returned value not identical to TRUE in any case.

See Also

inspect_usage