[Rd] R CMD check does not report redundant '...' argument described in Rd File
Georgi Boshnakov
georg|@bo@hn@kov @end|ng |rom m@nche@ter@@c@uk
Wed Apr 17 08:42:12 CEST 2019
R's checks seem to be failing to notice a redundant '...' argument described in the documentation of a function.
Consider a function:
fun_3 <- function(arg1, arg2, arg3) {
"I am fun_3"
}
If its documentation describes an argument, say 'dummy', R check reports something like:
* checking Rd \usage sections ... WARNING
Documented arguments not in \usage in documentation object 'fun_3b':
'dummy'
...
But if the non-existent argument is '...' or '\dots' there is no warning. The omission seems specific to the 'dots' argument.
Checked under Windows on win-builder on 17 April 2018 with
R version 3.6.0 beta (2019-04-16 r76403), R version 3.5.3 (2019-03-11) and
R version 3.4.4 (2018-03-15).
A minimal package illustrating this is at
https://github.com/GeoBosh/reprexes/tree/master/redundantDots
Georgi Boshnakov
More information about the R-devel
mailing list