Created attachment 1747 [details]
R CMD check toto_1.0.tar.gz reproduces the issue
[Sorry for reporting this bug again but my original bug report (https://bugs.r-project.org/bugzilla/show_bug.cgi?id=16153) was closed (NOT REPRODUCIBLE) before I was given a chance to provide a reproducible example (I did provide a reproducible example after the bug was already closed but the system would only let me change the status to RESOLVED or VERIFIED so I didn't change it). 8 days have passed now, and it looks unlikely that someone will re-open the issue. So here it is again.]
In the context of refactoring a function, some arguments might be added, dropped, and/or renamed. 'R CMD check' has always been a great tool to help keep the documentation in sync with the code after this type of change. I just ran into the following glitch though: documented arguments that are not in \usage are usually detected but it seems that ... is not.
Running 'R CMD check toto_1.0.tar.gz' (package attached) reproduces the issue. The toto() function (defined in the package) has only 1 arg:
In the man page for the toto() function, I've added entries for non-existing
args 'y' and '...':
but 'R CMD check toto_1.0.tar.gz' only complains about 'y' not being in
* checking Rd \usage sections ... WARNING
Documented arguments not in \usage in documentation object 'toto':
It says nothing about '...' not being in \usage.