CXCommentKind

\brief 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

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

CXComment_Text1

\brief Plain text. Inline content.

CXComment_InlineCommand2

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

For example: \\c command.

CXComment_HTMLStartTag3

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

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

CXComment_HTMLEndTag4

\brief HTML end tag. Considered inline content.

For example: \verbatim </a> \endverbatim

CXComment_Paragraph5

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

CXComment_BlockCommand6

\brief 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: \\brief 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

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

For example: \\param in ParamName description.

CXComment_TParamCommand8

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

For example: \\tparam T description.

CXComment_VerbatimBlockCommand9

\brief 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

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

CXComment_VerbatimLine11

\brief 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

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

Meta