From georg|@bo@hn@kov @end|ng |rom m@nche@ter@@c@uk  Wed Apr 17 08:42:12 2019
From: georg|@bo@hn@kov @end|ng |rom m@nche@ter@@c@uk (Georgi Boshnakov)
Date: Wed, 17 Apr 2019 06:42:12 +0000
Subject: [Rd] R CMD check does not report redundant '...' argument described
 in Rd File
Message-ID: <438D2EC9EAFE5946B2D5864670EA468E018F7165E6@MBXP02.ds.man.ac.uk>

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



[Rd] R CMD check does not report redundant '...' argument described in Rd File
Georgi Boshnakov