document options more explicitly (#6709)

Author: teunbrand

R/labels.R

@@ -175,7 +175,13 @@ make_labels <- function(mapping) {
 #'        See [get_alt_text] for examples. `alt` can also be a function that
 #'        takes the plot as input and returns text as output. `alt` also accepts
 #'        rlang [lambda][rlang::as_function()] function notation.
-#' @param ... A list of new name-value pairs. The name should be an aesthetic.
+#' @param ...
+#' New name-value pairs. The name should be an aesthetic. The values can be
+#' one of the following:
+#' * A string or expression to set a label verbatim.
+#' * A function to use as formatter for the default label.
+#' * `NULL` to remove a label.
+#' * A [`waiver()`] to use the default label.
 #' @export
 #'
 #' @seealso