document additional cases when dots are used (closes #1214)

NEWS.md

@@ -1,5 +1,9 @@
 # broom (development version)
 
+* Clarified documentation for a number of cases where dots were
+  documented as unused but actually passed to internal functions 
+  (#1214).
+
 * Addressed error in `augment.betareg()` and `augment.betamfx()` 
   with `data = NULL` and non-null `newdata` (#1216, #1218).
 

R/mass-negbin-tidiers.R

@@ -58,7 +58,8 @@ glance.negbin <- function(x, ...) {
 #'
 #' @param x A `glm.nb` object returned by [MASS::glm.nb()].
 #' @template param_confint
-#' @template param_unused_dots
+#' @param ... For `tidy()`, additional arguments passed to [summary()].
+#' Otherwise ignored.
 #'
 #' @family glm.nb tidiers
 #' @seealso [MASS::glm.nb()]

R/multcomp-tidiers.R

@@ -3,7 +3,8 @@
 #'
 #' @param x A `glht` object returned by [multcomp::glht()].
 #' @template param_confint
-#' @template param_unused_dots
+#' @param ... Additional arguments passed to [summary()] and
+#' [tidy.summary.glht()].
 #'
 #' @evalRd return_tidy("contrast", "null.value", "estimate")
 #'

R/survival-survfit-tidiers.R

@@ -2,7 +2,8 @@
 #' @template title_desc_tidy
 #'
 #' @param x An `survfit` object returned from [survival::survfit()].
-#' @template param_unused_dots
+#' @param ... For `glance.survfit()`, additional arguments passed 
+#' to [summary()]. Otherwise ignored.
 #'
 #' @evalRd return_tidy(
 #'   "time",

R/vars-tidiers.R

@@ -3,7 +3,8 @@
 #'
 #' @param x A `varest` object produced by a call to [vars::VAR()].
 #' @template param_confint
-#' @template param_unused_dots
+#' @param ... For `glance()`, additional arguments passed to [summary()].
+#' Otherwise ignored.
 #'
 #' @evalRd return_tidy(regression = TRUE,
 #'   component = "Whether a particular term was used to model the mean or the