clang 20.0.0git
Public Types | Public Member Functions | Public Attributes | List of all members
clang::comments::CommandInfo Struct Reference

Information about a single command. More...

#include "clang/AST/CommentCommandTraits.h"

Public Types

enum  { NumCommandIDBits = 20 }
 DRY definition of the number of bits used for a command ID. More...
 

Public Member Functions

unsigned getID () const
 

Public Attributes

const char * Name
 
const char * EndCommandName
 Name of the command that ends the verbatim block.
 
unsigned ID: NumCommandIDBits
 The ID of the command.
 
unsigned NumArgs: 4
 Number of word-like arguments for a given block command, except for \param and \tparam commands – these have special argument parsers.
 
unsigned IsInlineCommand: 1
 True if this command is a inline command (of any kind).
 
unsigned IsBlockCommand: 1
 True if this command is a block command (of any kind).
 
unsigned IsBriefCommand: 1
 True if this command is introducing a brief documentation paragraph (\or an alias).
 
unsigned IsReturnsCommand: 1
 True if this command is \returns or an alias.
 
unsigned IsParamCommand: 1
 True if this command is introducing documentation for a function parameter (\param or an alias).
 
unsigned IsTParamCommand: 1
 True if this command is introducing documentation for a template parameter (\tparam or an alias).
 
unsigned IsThrowsCommand: 1
 True if this command is \throws or an alias.
 
unsigned IsDeprecatedCommand: 1
 True if this command is \deprecated or an alias.
 
unsigned IsHeaderfileCommand: 1
 True if this is a \headerfile-like command.
 
unsigned IsParCommand: 1
 True if this is a \par command.
 
unsigned IsEmptyParagraphAllowed: 1
 True if we don't want to warn about this command being passed an empty paragraph.
 
unsigned IsVerbatimBlockCommand: 1
 True if this command is a verbatim-like block command.
 
unsigned IsVerbatimBlockEndCommand: 1
 True if this command is an end command for a verbatim-like block.
 
unsigned IsVerbatimLineCommand: 1
 True if this command is a verbatim line command.
 
unsigned IsDeclarationCommand: 1
 True if this command contains a declaration for the entity being documented.
 
unsigned IsFunctionDeclarationCommand: 1
 True if verbatim-like line command is a function declaration.
 
unsigned IsRecordLikeDetailCommand: 1
 True if block command is further describing a container API; such as @coclass, @classdesign, etc.
 
unsigned IsRecordLikeDeclarationCommand: 1
 True if block command is a container API; such as @interface.
 
unsigned IsUnknownCommand: 1
 True if this command is unknown.
 

Detailed Description

Information about a single command.

When reordering, adding or removing members please update the corresponding TableGen backend.

Definition at line 32 of file CommentCommandTraits.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

DRY definition of the number of bits used for a command ID.

Enumerator
NumCommandIDBits 

Definition at line 43 of file CommentCommandTraits.h.

Member Function Documentation

◆ getID()

unsigned clang::comments::CommandInfo::getID ( ) const
inline

Member Data Documentation

◆ EndCommandName

const char* clang::comments::CommandInfo::EndCommandName

Name of the command that ends the verbatim block.

Definition at line 40 of file CommentCommandTraits.h.

◆ ID

unsigned clang::comments::CommandInfo::ID

The ID of the command.

Definition at line 46 of file CommentCommandTraits.h.

Referenced by getID().

◆ IsBlockCommand

unsigned clang::comments::CommandInfo::IsBlockCommand

◆ IsBriefCommand

unsigned clang::comments::CommandInfo::IsBriefCommand

True if this command is introducing a brief documentation paragraph (\or an alias).

Definition at line 63 of file CommentCommandTraits.h.

Referenced by clang::comments::BriefParser::Parse().

◆ IsDeclarationCommand

unsigned clang::comments::CommandInfo::IsDeclarationCommand

True if this command contains a declaration for the entity being documented.

For example:

\fn void f(int a);

Definition at line 126 of file CommentCommandTraits.h.

◆ IsDeprecatedCommand

unsigned clang::comments::CommandInfo::IsDeprecatedCommand

True if this command is \deprecated or an alias.

Definition at line 85 of file CommentCommandTraits.h.

◆ IsEmptyParagraphAllowed

unsigned clang::comments::CommandInfo::IsEmptyParagraphAllowed

True if we don't want to warn about this command being passed an empty paragraph.

Meaningful only for block commands.

Definition at line 98 of file CommentCommandTraits.h.

◆ IsFunctionDeclarationCommand

unsigned clang::comments::CommandInfo::IsFunctionDeclarationCommand

True if verbatim-like line command is a function declaration.

Definition at line 130 of file CommentCommandTraits.h.

◆ IsHeaderfileCommand

unsigned clang::comments::CommandInfo::IsHeaderfileCommand

True if this is a \headerfile-like command.

Definition at line 89 of file CommentCommandTraits.h.

◆ IsInlineCommand

unsigned clang::comments::CommandInfo::IsInlineCommand

True if this command is a inline command (of any kind).

Definition at line 54 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseParagraphOrBlockCommand().

◆ IsParamCommand

unsigned clang::comments::CommandInfo::IsParamCommand

True if this command is introducing documentation for a function parameter (\param or an alias).

Definition at line 72 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseBlockCommand().

◆ IsParCommand

unsigned clang::comments::CommandInfo::IsParCommand

True if this is a \par command.

Definition at line 93 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseBlockCommand().

◆ IsRecordLikeDeclarationCommand

unsigned clang::comments::CommandInfo::IsRecordLikeDeclarationCommand

True if block command is a container API; such as @interface.

Definition at line 139 of file CommentCommandTraits.h.

◆ IsRecordLikeDetailCommand

unsigned clang::comments::CommandInfo::IsRecordLikeDetailCommand

True if block command is further describing a container API; such as @coclass, @classdesign, etc.

Definition at line 135 of file CommentCommandTraits.h.

◆ IsReturnsCommand

unsigned clang::comments::CommandInfo::IsReturnsCommand

True if this command is \returns or an alias.

Definition at line 67 of file CommentCommandTraits.h.

Referenced by clang::comments::BriefParser::Parse().

◆ IsThrowsCommand

unsigned clang::comments::CommandInfo::IsThrowsCommand

True if this command is \throws or an alias.

Definition at line 81 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseBlockCommand().

◆ IsTParamCommand

unsigned clang::comments::CommandInfo::IsTParamCommand

True if this command is introducing documentation for a template parameter (\tparam or an alias).

Definition at line 77 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseBlockCommand().

◆ IsUnknownCommand

unsigned clang::comments::CommandInfo::IsUnknownCommand

True if this command is unknown.

This CommandInfo object was created during parsing.

Definition at line 144 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseParagraphOrBlockCommand(), and clang::comments::CommandTraits::registerUnknownCommand().

◆ IsVerbatimBlockCommand

unsigned clang::comments::CommandInfo::IsVerbatimBlockCommand

True if this command is a verbatim-like block command.

A verbatim-like block command eats every character (except line starting decorations) until matching end command is seen or comment end is hit.

Definition at line 105 of file CommentCommandTraits.h.

◆ IsVerbatimBlockEndCommand

unsigned clang::comments::CommandInfo::IsVerbatimBlockEndCommand

True if this command is an end command for a verbatim-like block.

Definition at line 109 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseParagraphOrBlockCommand().

◆ IsVerbatimLineCommand

unsigned clang::comments::CommandInfo::IsVerbatimLineCommand

True if this command is a verbatim line command.

A verbatim-like line command eats everything until a newline is seen or comment end is hit.

Definition at line 116 of file CommentCommandTraits.h.

◆ Name

const char* clang::comments::CommandInfo::Name

◆ NumArgs

unsigned clang::comments::CommandInfo::NumArgs

Number of word-like arguments for a given block command, except for \param and \tparam commands – these have special argument parsers.

Definition at line 50 of file CommentCommandTraits.h.

Referenced by clang::comments::Parser::parseBlockCommand(), and clang::comments::Parser::parseInlineCommand().


The documentation for this struct was generated from the following file: