@inheritParams: what to do when using ...

[dsweber2]

We have a function which inherits all the parameters from another function, and want to just pass ... on to the next function. But document both complains that ... isn't documented, and it doesn't include the arguments from the other function.

A minimal example of what I'm talking about:

#' @param a an argument
#' @param b a different argument
foo <- function(a=3, b=5) {}
#' @param extra_arg an argument giving the extra functionality
#' @inheritParams foo
bar <- function(extra_arg, ...) {
   foo(...)
}

In the docs, it would be useful if bar showed all the arguments of foo, but there doesn't seem to be a way to do this, unless you copy every argument.

[dsweber2]

Found it; it's documented here. Sorry for the issue spam.

@inheritDotParams ${1:source} ${2:arg1 arg2 arg3}: Automatically generate documentation for ... when you're passing dots along to another function.