Parse, transform and serialize roxygen comments
Source:R/transform-files.R
parse_transform_serialize_roxygen.Rd
Splits text
into roxygen code examples and non-roxygen code examples and
then maps over these examples by applying
style_roxygen_code_example()
.
Hierarchy
Styling involves splitting roxygen example code into segments, and segments
into snippets. This describes the process for input of
parse_transform_serialize_roxygen()
:
Splitting code into roxygen example code and other code. Downstream, we are only concerned about roxygen code. See
parse_transform_serialize_roxygen()
.Every roxygen example code can have zero or more dontrun / dontshow / donttest sequences. We next create segments of roxygen code examples that contain at most one of these. See
style_roxygen_code_example()
.We further split the segment that contains at most one dont* sequence into snippets that are either don* or not. See
style_roxygen_code_example_segment()
.
Finally, that we have roxygen code snippets that are either dont* or not,
we style them in style_roxygen_example_snippet()
using
parse_transform_serialize_r()
.