Document Object Model Reference

The Document Object Model (DOM) is a tree structure that represents the symbols extracted from the source code. The DOM is used by the generator to render the documentation.

Top-Level Fields

The top-level object in the DOM is the context for a template. The top-level object has the following properties:

Property Type Description

symbol

Symbol Object

The symbol being rendered.

config

Config Object

The configuration object.

Symbol

The Symbol object represents a symbol extracted from the source code. The symbol being rendered is available in the symbol object in the Handlebars context. The symbol object has the following properties:

Property Type Description

id

string

A unique identifier for the symbol.

name

string

The nonqualified name of the symbol.

kind

string

The kind of symbol. (e.g., class, function, variable)

access

string

The access level of the symbol. (e.g., public, protected, private)

extraction

string

The extraction mode of the symbol according to the specified filters. (e.g., regular, see-below, implementation-defined, dependency)

isRegular

bool

Whether the symbol extraction mode is regular.

isSeeBelow

bool

Whether the symbol extraction mode is see-below.

isImplementationDefined

bool

Whether the symbol extraction mode is implementation-defined.

isDependency

bool

Whether the symbol extraction mode is dependency.

parents

Symbol Object[]

The parent contexts (namespaces or records) of the symbol.

parent

Symbol Object

The parent context (namespace or record) of the symbol.

doc

Any

The documentation for the symbol.

Handlebars generators extend each symbol with the following fields:

Property Type Description

url

string

The URL of the symbol. If the documentation is a single page, this is the anchor link to the symbol starting with #. If the documentation is multipage, this is the path to the symbol starting with /.

anchor

string

The anchor link to the symbol. This is used for section IDs in the documentation.

The Symbol object has additional properties based on the kind of symbol. The following table lists the additional properties for symbols that contain information about their scope (such as Namespaces and Classes):

Property Type Description

members

Symbol Object[]

The members of that scope (e.g., member functions, namespace symbols).

overloads

Symbol Object[]

Same as members, but groups overloaded functions as unique symbols of kind overload.

Symbol objects that contain information about the location include the following properties:

Property Type Description

loc

Source Object

The location of the symbol in the source code.

When the symbol kind is namespace, the symbol object has the following additional properties:

Property Type Description

interface

Tranche Object

The interface of the namespace.

usingDirectives

Symbol Object[]

The using directives of the namespace.

When the symbol kind is record (e.g., class, struct, union), the symbol object has the following additional properties:

Property Type Description

tag

string

The type of record (e.g., class, struct, union).

defaultAccess

string

The default access level of the record members (e.g., public, private).

isFinal

bool

Whether the record is final.

isTypedef

bool

Whether the record is a typedef.

bases

Base Symbol Object[]

The base classes of the record.

interface

Interface Object

The interface of the record.

template

Template Object

The template information of the record.

When the symbol kind is enum, the symbol object has the following additional properties:

Property Type Description

type

Type Object

The type information of the enum.

isScoped

bool

Whether the enum is scoped.

When the symbol kind is function, the symbol object has the following additional properties:

Property Type Description

isVariadic

bool

Whether the function is variadic.

isVirtual

bool

Whether the function is virtual.

isVirtualAsWritten

bool

Whether the function is virtual as written.

isPure

bool

Whether the function is pure.

isDefaulted

bool

Whether the function is defaulted.

isExplicitlyDefaulted

bool

Whether the function is explicitly defaulted.

isDeleted

bool

Whether the function is deleted.

isDeletedAsWritten

bool

Whether the function is deleted as written.

isNoReturn

bool

Whether the function is noreturn.

hasOverrideAttr

bool

Whether the function has the override attribute.

hasTrailingReturn

bool

Whether the function has a trailing return type.

isConst

bool

Whether the function is const.

isVolatile

bool

Whether the function is volatile.

isFinal

bool

Whether the function is final.

isNodiscard

bool

Whether the function is nodiscard.

isExplicitObjectMemberFunction

bool

Whether the function is an explicit object member function.

constexprKind

string

The constexpr kind of the function (e.g., consteval, constexpr).

storageClass

string

The storage class of the function (e.g., static, extern).

refQualifier

string

The reference qualifier of the function (e.g., &, &&).

class

string

The function class (e.g., constructor, conversion, destructor).

params

Param Object[]

The parameters of the function.

return

Type Object

The return type of the function.

template

Template Object

The template information of the function.

overloadedOperator

string

The overloaded operator of the function.

exceptionSpec

string

The exception specification of the function.

explicitSpec

string

The explicit specification of the function.

requires

string

The requires expression of the function.

attributes

string[]

The attributes of the function.

When the symbol kind is typedef, the symbol object has the following additional properties:

Property Type Description

type

Type Object

The type information of the typedef.

template

Template Object

The template information of the typedef.

isUsing

bool

Whether the typedef is a using declaration.

When the symbol kind is variable, the symbol object has the following additional properties:

Property Type Description

type

Type Object

The type information of the variable.

template

Template Object

The template information of the variable.

storageClass

string

The storage class of the variable (e.g., static, extern).

isInline

bool

Whether the variable is inline.

isConstexpr

bool

Whether the variable is constexpr.

isConstinit

bool

Whether the variable is constinit.

isThreadLocal

bool

Whether the variable is thread-local.

initializer

string

The initializer of the variable.

attributes

string[]

The attributes of the variable.

When the symbol kind is field (i.e. non-static data members), the symbol object has the following additional properties:

Property Type Description

type

Type Object

The type information of the field.

default

string

The default value of the field.

isMaybeUnused

bool

Whether the field is maybe unused.

isDeprecated

bool

Whether the field is deprecated.

isVariant

bool

Whether the field is a variant.

isMutable

bool

Whether the field is mutable.

isBitfield

bool

Whether the field is a bitfield.

hasNoUniqueAddress

string

Whether the field has the attribute.

bitfieldWidth

string

The width of the bitfield.

attributes

string[]

The attributes of the field.

When the symbol kind is friend, the symbol object has the following additional properties:

Property Type Description

name

string

The name of the friend symbol or type.

symbol

Symbol Object

The friend symbol.

type

Type Object

The friend type.

When the symbol kind is namespace-alias, the symbol object has the following additional properties:

Property Type Description

aliasedSymbol

Name Object

The aliased symbol.

When the symbol kind is using, the symbol object has the following additional properties:

Property Type Description

class

string

The class of the using declaration (e.g., normal, typename, enum).

shadows

Symbol Object[]

The symbols being used.

qualifier

Name Object

The qualifier of the using declaration.

When the symbol kind is enum-constant, the symbol object has the following additional properties:

Property Type Description

initializer

string

The initializer of the enum-constant.

When the symbol kind is guide, the symbol object has the following additional properties:

Property Type Description

params

Param Object[]

The parameters of the guide.

deduced

Type Object

The deduced type of the guide.

template

Template Object

The template information of the guide.

explicitSpec

string

The explicit specification of the guide.

When the symbol kind is concept, the symbol object has the following additional properties:

Property Type Description

template

Template Object

The template information of the concept.

constraint

string

The constraint of the concept.

Source Fields

The Source object represents the location of the symbol in the source code. The source info object has the following properties:

Property Type Description

def

Location Object

Location where the entity was defined.

decl

Location Object[]

Locations where the entity was declared.

Tranche Object Fields

The Tranche object represents the symbols in a scope (e.g., namespace). The tranche object has the following properties:

Property Type Description

(symbol kind in plural form: e.g., classes, functions, variables)

Symbol Object[]

The symbols of that kind in the scope.

types

Symbol Object[]

The types in the scope.

staticfuncs

Symbol Object[]

The static functions in the scope.

overloads

Symbol Object[]

The overloads in the scope.

staticoverloads

Symbol Object[]

The static overloads in the scope.

Interface Object Fields

The Interface object represents the interface of a record (e.g., class, struct, union). The interface object has the following properties:

Property Type Description

public

Tranche Object

The public interface of the record.

protected

Tranche Object

The protected interface of the record.

private

Tranche Object

The private interface of the record.

Base Info Fields

The Base Info object represents a base class of a record. The base info object has the following properties:

Property Type Description

access

string

The access level of the base class.

isVirtual

bool

Whether the base class is virtual.

type

Type Object

The type information of the base class.

Template Fields

The Template object represents the template information of a record, function, or typedef. The template info object has the following properties:

Property Type Description

kind

string

The kind of template (e.g., explicit, partial).

primary

Symbol Object

The primary template.

params

tParam Object[]

The template parameters.

args

Type Object[]

The template arguments.

requires

string

The requires expression of the template.

Type Fields

The Type object represents the type information of a symbol. The type info object has the following properties:

Property Type Description

kind

string

The kind of type (e.g., named, decltype, auto, pointer, reference, array, function).

is-pack

bool

Whether the type is a pack expansion.

name

string

The name of the type.

operand

string

The operand of the type.

keyword

string

The keyword of the type.

constraint

string

The constraint of the type.

cv-qualifiers

string

The cv qualifier of the type (e.g., const, volatile).

parent-type

Type Object

The parent type of the type.

pointee-type

Type Object

The pointee type of the type.

element-type

Type Object

The element type of the type.

bounds-value

string

The bounds value of the type.

bounds-expr

string

The bounds expression of the type.

return-type

Type Object

The return type of the type.

param-types

Type Object[]

The parameter types of the type.

exception-spec

string

The exception specification of the type.

ref-qualifier

string

The reference qualifier of the type.

is-variadic

bool

Whether the type is variadic.

Param Fields

The Param object represents the parameter of a function. The param object has the following properties:

Property Type Description

name

string

The name of the parameter.

type

Type Object

The type information of the parameter.

default

string

The default value of the parameter.

Name Fields

The Name object represents the name of a symbol. The name info object has the following properties:

Property Type Description

name

string

The name of the symbol.

symbol

string

The unique identifier of the symbol.

args

Type Object[]

The template arguments of the symbol.

prefix

string

The prefix of the symbol.

Location Fields

The Location object represents the location of a symbol in the source code. The location object has the following properties:

Property Type Description

fullPath

string

The full path of the source file.

shortPath

string

The path of the source file relative to the search directories.

sourcePath

string

The path of the source file relative to the source-root.

line

integer

The line number of the symbol at this location.

documented

bool

Whether the symbol is documented at this location.

TParam Fields

The TParam object represents a template parameter of a record, function, or typedef. The tparam object has the following properties:

Property Type Description

kind

string

The kind of template parameter (e.g., type, non-type, template).

name

string

The name of the template parameter.

is-pack

bool

Whether the template parameter is a pack expansion.

default

string

The default value of the template parameter.

key

string

The key kind of the template parameter.

constraint

string

The constraint of the template parameter.

type

Type Object

The type information of the template parameter.

params

TParam Object[]

The template parameters of the template parameter.

Targ Fields

The Targ object represents a template argument of a record, function, or typedef. The targ object has the following properties:

Property Type Description

kind

string

The kind of template argument (e.g., type, non-type, template).

is-pack

bool

Whether the template argument is a pack expansion.

type

Type Object

The type information of the template argument.

value

string

The value of the template argument.

name

string

The name of the template argument.

template

Template Object

The template information of the template argument.

Config Fields

The Config object represents the configuration object. It includes all values provided to Mr.Docs in the configuration file or via the command line. Please refer to the configuration options reference for more information.