Decorates a tool with information from its man page, assuming its underlying function comes from a package. The extracted information includes the description, argument (parameter) descriptions, and return value description.

describe_with_Rd(tool)

Arguments

tool

The Tool object to describe.

Details

To find the man page, the search algorithm first looks for a function with the tool's name in the enclosing environment of the underlying function. If not found, it linearly searches the enclosing environment for an identical function.

Value

The input object except with newly declared examples.

Author

Michael Lawrence

Examples

if (FALSE) { # \dontrun{
    aggregate_tool <- tool(aggregate) |>
        can_accept_as(x = class_formula, data = class_name, FUN = class_name) |>
        demonstrate(c(x = MPG.city ~ Origin, alist(data = Cars93, FUN = median)),
                    "the median of MPG.city by Origin in Cars93")
    agent <- equip(llama(), aggregate_tool)
    data(Cars93, package = "MASS")
    predict(agent,
            "Mean of MPG.city for each Manufacturer in the Cars93 dataset")
} # }