Learn R Programming

rstudioapi (version 0.14)

sourceMarkers: Display source markers

Description

Display user navigable source markers in a pane within RStudio.

Usage

sourceMarkers(
  name,
  markers,
  basePath = NULL,
  autoSelect = c("none", "first", "error")
)

Arguments

name

The name of marker set. If there is a market set with this name already being shown, those markers will be replaced.

markers

An R list, or data.frame, of source markers. See details for more details on the expected format.

basePath

Optional. If all source files are within a base path, then specifying that path here will result in file names being displayed as relative paths. Note that in this case markers still need to specify source file names as full paths.

autoSelect

Auto-select a marker after displaying the marker set?

Details

The markers argument can contains either a list of marker lists or a data frame with the appropriate marker columns. The fields in a marker are as follows (all are required):

typeThe marker type ("error", "warning", "info", "style", or "usage").
fileThe path to the associated source file.
lineThe line number for the associated marker.
columnThe column number for the associated marker.
messageA message associated with the marker at this location.

Note the marker message can contain ANSI SGR codes for formatting. The cli package can format text for style and color.