Skip to contents

Returns a predefined label intended to be used to document functions using roxygen2 tags.

Usage

roxy_lbl(id = roxy_lbls()$id, type = "default", as_sentence = TRUE, ...)

Arguments

id

Label identifier. See roxy_lbls() for possible values.

type

The label type to return the label value for. One of "default", "author", "concept", "description", "details", "field", "format", "keywords", "param", "references", "return", "section", "seealso", "slot", "source" or "title".

as_sentence

Whether or not to format the resulting string as a full sentence, i.e. with the first letter capitalized and a period at the end.

...

Further named arguments used to tailor the label to your needs. Not all labels require additional arguments, see roxy_lbls() for an overview. If a required argument is not explicitly provided, it is searched for in the parent frames.

Value

A glue character scalar.

Details

The labels can be inserted using inline R code as follows:

#' @param start_date `r pkgsnip::roxy_lbl("start_date", type = "param")`
#' @return `r pkgsnip::roxy_lbl("tibble", type = "return")`

Note that the above only works in roxygen2 7.1.0+.

See also