Surfaces every \dontrun{} block in man/*.Rd, with the source
Rd file, the documented topic, the line number, and a one-line
suggestion of the modern equivalent. CRAN policy is that
\dontrun{} should only wrap example code that genuinely cannot
be executed (missing API key, missing system dependency, side
effect on the user's filespace). The contributor should otherwise
use \donttest{}, which still gets exercised by
R CMD check --run-donttest but is skipped by default.
audit_dontrun(pkg = ".")A tibble with columns rd_file, topic, line,
suggestion. Empty when the package has no \dontrun{}
blocks, or when there is no man/ directory.
Detection is purely static: each Rd file is read line-by-line and
the literal \dontrun{ opener is matched (commented-out forms
starting with % are ignored). The function never sources the
file and never executes user code.
if (FALSE) { # \dontrun{
audit_dontrun(".")
} # }