roxy_block: Blocks

Description Usage Arguments Examples

View source: R/block.R

Description

A roxy_block represents a single roxygen2 block.

The block_* functions provide a few helpers for common operations:

Usage

1
2
3
4
5
6
7
8
9
roxy_block(tags, file, line, call, object = NULL)

block_has_tags(block, tags)

block_get_tags(block, tags)

block_get_tag(block, tag)

block_get_tag_value(block, tag)

Arguments

tags

A list of roxy_tags.

file, line

Location of the call (i.e. the line after the last line of the block).

call

Expression associated with block.

object

Optionally, the object associated with the block, found by inspecting/evaluating call.

block

A roxy_block to manipulate.

tag, tags

Either a single tag name, or a character vector of tag names.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# The easiest way to see the structure of a roxy_block is to create one
# using parse_text:
text <- "
  #' This is a title
  #'
  #' @param x,y A number
  #' @export
  f <- function(x, y) x + y
"

# parse_text() returns a list of blocks, so I extract the first
block <- parse_text(text)[[1]]
block

roxygen2 documentation built on Sept. 8, 2021, 9:08 a.m.