Renders one top-level <para>’s mixed content into ordered text chunks.
Doxygen bundles a member’s free-flowing prose paragraphs together with
structured sections (<simplesect>, <xrefsect>, <parameterlist>,
<programlisting>) as siblings inside the SAME enclosing <para> – a
naive element.findall(".//para") (matching at any depth) both loses
each section’s own semantic label (Doxygen attaches it via a kind
attribute or a separate <xreftitle> sibling element, not as part of the
text itself) and re-visits each nested <para> a second time on top of
the outer para’s own full-recursive itertext() – confirmed real via a
real doxygen capture (DEL-B40): “This method is thread-safe.” and
“BugKnown bug here.” (the xreftitle “Bug” glued directly onto its own
description, no separating whitespace in the source XML) each appeared
TWICE in the resulting docstring.
docstring.
Returns:
Ordered text chunks: plain prose runs, and one already-labeled chunk
Methods
_render_para_content
_render_para_content(para: A XML element that is a DIRECT child of a) -> List[str]
Renders one top-level <para>’s mixed content into ordered text chunks.
Doxygen bundles a member’s free-flowing prose paragraphs together with
structured sections (<simplesect>, <xrefsect>, <parameterlist>,
<programlisting>) as siblings inside the SAME enclosing <para> – a
naive element.findall(".//para") (matching at any depth) both loses
each section’s own semantic label (Doxygen attaches it via a kind
attribute or a separate <xreftitle> sibling element, not as part of the
text itself) and re-visits each nested <para> a second time on top of
the outer para’s own full-recursive itertext() – confirmed real via a
real doxygen capture (DEL-B40): “This method is thread-safe.” and
“BugKnown bug here.” (the xreftitle “Bug” glued directly onto its own
description, no separating whitespace in the source XML) each appeared
TWICE in the resulting docstring.
docstring.
Returns:
Ordered text chunks: plain prose runs, and one already-labeled chunk
| Parameter | Type | Description |
|---|---|---|
| para | A XML element that is a DIRECT child of a |
Generated with Flude
Copyright © 2026