CXCommentKind

Describes the type of the comment AST node (\c CXComment). A comment node can be considered block content (e. g., paragraph), inline content (plain text) or neither (the root AST node).

Values

ValueMeaning
CXComment_Null0

Null comment. No AST node is constructed at the requested location because there is no text or a syntax error.

CXComment_Text1

Plain text. Inline content.

CXComment_InlineCommand2

A command with word-like arguments that is considered inline content.

For example: \\c command.

CXComment_HTMLStartTag3

HTML start tag with attributes (name-value pairs). Considered inline content.

For example: \verbatim <br> <br /> <a href="http://example.org/"> \endverbatim

CXComment_HTMLEndTag4

HTML end tag. Considered inline content.

For example: \verbatim </a> \endverbatim

CXComment_Paragraph5

A paragraph, contains inline comment. The paragraph itself is block content.

CXComment_BlockCommand6

A command that has zero or more word-like arguments (number of word-like arguments depends on command name) and a paragraph as an argument. Block command is block content.

Paragraph argument is also a child of the block command.

For example: \has 0 word-like arguments and a paragraph argument.

AST nodes of special kinds that parser knows about (e. g., \\param command) have their own node kinds.

CXComment_ParamCommand7

A \\param or \\arg command that describes the function parameter (name, passing direction, description).

For example: \\param in ParamName description.

CXComment_TParamCommand8

A \\tparam command that describes a template parameter (name and description).

For example: \\tparam T description.

CXComment_VerbatimBlockCommand9

A verbatim block command (e. g., preformatted code). Verbatim block has an opening and a closing command and contains multiple lines of text (\c CXComment_VerbatimBlockLine child nodes).

For example: \\verbatim aaa \\endverbatim

CXComment_VerbatimBlockLine10

A line of text that is contained within a CXComment_VerbatimBlockCommand node.

CXComment_VerbatimLine11

A verbatim line command. Verbatim line has an opening command, a single line of text (up to the newline after the opening command) and has no closing command.

CXComment_FullComment12

A full comment attached to a declaration, contains block content.

Meta