Am 14.02.26 um 12:35 schrieb Ivan Krylov via R-devel:
This was discussed a bit in July 2025:
https://stat.ethz.ch/pipermail/r-package-devel/2025q3/011824.html
Part of the problem with an automatic check is that it can be easily
circumvented by adding a one-line value section (as many packages are
wont to do, "#' @return data.frame" with no further context), so human
review will still be needed.
It's probably worth adding such a check [...]
not reported by R CMD check by default
Thanks, I agree. There is no technical requirement for a \value section
in Rd files but I suppose package reviewers will have a keen sense of
when one is really missing or incomplete. That said, an indication of
help pages without a \value section would certainly be useful for
developers.
With r89420, there now is an experimental environment variable
_R_CHECK_RD_CONTENTS_VALUE_
for tools::checkRdContents(), a function also used by R CMD check. If
set to a true value, the check results will show (some of the) Rd files
without \value.
Sebastian Meyer
______________________________________________
[email protected] mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
