Get predefined @param label — param_lbl • pkgsnip

Returns a predefined label intended to be used to document a function parameter using roxygen2's @param tag.

Usage

param_lbl(id = roxy_lbls(type = "param")$id, ...)

Arguments

id: Label identifier. See roxy_lbls() for possible values.
...: Further named arguments passed on to roxy_lbl().

Value

A glue character scalar.

Details

A label can be inserted using inline R code as follows:

#' @param PARAM_NAME `r pkgsnip::param_lbl("ID")`

Note that the above only works in roxygen2 7.1.0+.

Currently, the following parameter labels are available:

id	arguments
`cli_markup_support`
`date`
`dates`
`datetime`
`datetimes`
`dbi_connection`
`df_or_tibble`
`dm`
`dyn_dots_support`
`end_date`
`eol`
`ggplot2_obj`
`glue_chr`
`gt_obj`
`max_cache_age`
`num_vrsn`
`opt_global_max_cache_age`	`pkg`, `global_max_cache_age`
`path`
`paths`
`pkg_config`	`pkg`
`plotly_obj`
`quiet`
`r_obj`
`resp_obj`
`show_progress`
`start_date`
`strict_list`
`sym`
`tbl_data`
`tibble`
`tibble_cols`	`cols`
`tibble_custom`	`custom`
`tidy_select_support`
`use_cache`

See also

roxygen2 label functions data_roxy_lbls, description_lbl(), return_lbl(), roxy_lbl(), roxy_lbls(), title_lbl()