Module roxygen 

Roxygen tag extraction and processing for R wrapper generation.

This module extracts roxygen2-style tags (e.g., @param, @examples) from Rust doc comments and propagates them to generated R wrapper code.

Usage

In Rust doc comments, use roxygen2 tags:

/// @param x A numeric input.
/// @return The squared value.
/// @examples
/// square(4)
#[miniextendr]
pub fn square(x: f64) -> f64 { x * x }

R Package Configuration

For roxygen2 to process multiline tags correctly, add this to your DESCRIPTION file:

Roxygen: list(markdown = TRUE)

Constants

METHOD_ONLY_TAGS 🔒

Roxygen tags that only make sense on individual methods, not on impl blocks.

MULTILINE_TAGS 🔒

Tags that allow multi-line content (continuation lines appended). All other tags are treated as single-line.

Functions

class_source_tag 🔒

Build a roxygen @source traceability line for a class definition.

doc_conflict_warnings 🔒

Check for conflicts between explicit @title/@description tags and implicit values.

find_tag_value 🔒

Find the value of a specific roxygen tag (e.g., “title” for @title ...).

format_roxygen_tags 🔒

Render roxygen tag lines as “#’ …” comment lines.

has_roxygen_tag 🔒

Return true if the tag list contains a specific roxygen tag.

implicit_description_from_attrs 🔒

Extract the implicit description from doc attributes (second paragraph).

implicit_details_from_attrs 🔒

Extract the implicit details from doc attributes (paragraphs 3+).

implicit_title_from_attrs 🔒

Extract the implicit title from doc attributes (first sentence, up to first . or newline).

is_multiline_tag 🔒

Check if a tag name supports multi-line content.

method_source_tag 🔒

Build a roxygen @source traceability line for a class method.

normalize_for_comparison 🔒

Normalize text for comparison: lowercase, collapse whitespace, strip trailing punctuation.

push_roxygen_tags 🔒

Push roxygen tag lines into a vector of R wrapper lines.

push_roxygen_tags_str 🔒

Like push_roxygen_tags but takes &[&str] for filtered tag slices.

roxygen_tag_name 🔒

Extract the tag name from a roxygen line (everything between @ and the first whitespace character). Returns None for lines that don’t start with a tag.

roxygen_tags_from_attrs 🔒

Extract roxygen tag lines (starting with ‘@’) from Rust doc attributes.

roxygen_tags_from_attrs_for_r6_method 🔒

Extract roxygen tags with optional auto-description for impl methods.

roxygen_tags_from_attrs_impl 🔒

Core implementation of roxygen tag extraction from #[doc = "..."] attributes.

strip_method_tags 🔒

Filter out method-specific roxygen tags from impl-block-level docs and emit compile warnings for each stripped tag.

strip_roxygen_from_attrs 🔒

Strip roxygen tag lines from doc attributes, keeping only regular documentation.

tag_names 🔒

Extract the set of tag names from a list of roxygen tag strings.