The @iparam <name> <description>
tag can be used in roxygen2
documentation
of a function to describe a dataframe parameter. The function must be using
interfacer::iface
to define the input dataframe parameter format. The
@iparam
tag will then generate documentation about the type of dataframe
the function is expecting.
Value
an roxygen2::rd_section
(see roxygen2
documentation)
Examples
# An example function definition:
fn_definition <- "
#' This is a title
#'
#' This is the description.
#'
#' @md
#' @iparam df the input
#' @export
f <- function(df = interfacer::iface(
id = integer ~ \"an integer `ID`\",
test = logical ~ \"the test result\"
)) {
ivalidate(df)
}
"
# For this example we manually parse the function specification in `fn_definition`
# creating a .Rd block - normally this is done by `roxygen2` which then
# writes this to an .Rd file. This function is not intended to be used
# outside of a call to `devtools::document`.
tmp = roxygen2::parse_text(fn_definition)
print(tmp)
#> [[1]]
#> <roxy_block> [<text>:9]
#> $tag
#> [line: 2] @title 'This is a title' {parsed}
#> [line: 4] @description 'This is the description.' {parsed}
#> [line: 6] @md '' {parsed}
#> [line: 7] @iparam 'df the input' {parsed}
#> [line: 8] @export '' {parsed}
#> [line: 9] @usage '<generated>' {parsed}
#> [line: 9] @.formals '<generated>' {parsed}
#> [line: 9] @backref '<generated>' {parsed}
#> $call f <- function(df = interfacer::iface(id = integer ~ "an integer `ID`", ...
#> $object <function>
#> $topic f
#> $alias f
#>