Document splicing argument in theme()

[olivroy]

Attempt to document better #5543

[teunbrand]

Thanks for the PR! Should we mention the splicing option for aes() too?

[olivroy]

Thanks for the suggestion.

I don't think it is worth bothering with aes(). Here is how it is currently documented:

#' @param x,y,... <[`data-masking`][rlang::topic-data-mask]> List of name-value
#'   pairs in the form `aesthetic = variable` describing which variables in the
#'   layer data should be mapped to which aesthetics used by the paired
#'   geom/stat. The expression `variable` is evaluated within the layer data, so
#'   there is no need to refer to the original dataset (i.e., use
#'   `ggplot(df, aes(variable))` instead of `ggplot(df, aes(df$variable))`).
#'   The names for x and y aesthetics are typically omitted because they are so
#'   common; all other aesthetics must be named.

Also, the upcoming version of RStudio will no longer show ... in autocompletion for aes(). rstudio/rstudio#8444

[teunbrand]

I don't think it is worth bothering with aes().

Fair enough. If you could hit devtools::document() to populate the .Rd file, I think this should be good to go.

[teunbrand]

Thanks for the contribution!