Write a message of different categories to different destinations. - `level` - 'diag' (diagnostic, voluminous) -

Find a {Type|Enum|Cmd}Info object by name. Intended for internal use only. If an object qualified by API name exists, use that.

Return string argument, or "" if argument is None. Used in converting etree Elements into text. s - string to convert

Add information about an element to the corresponding dictionary. Intended for internal use only. - elem - `<type>`/`<enums>`/`<enum

Print a newline to the output file (utility function)

Append a definition to the specified section

Return True if self.elem and info.elem have the same attribute value for key. If 'required' is not True, also returns True if ne

Substitute a regular expression which matches no version or extension names for None or the empty string.

Parse and convert an `<enum>` tag into a value. - elem - <enum> Element - needsNum - generate a numeric representation of the element

If an API element is marked deprecated, return a brief comment describing why. Otherwise, return an empty string. - e

Return whether an API and profile being generated matches an element's profile - api - string naming the API to match - profile - string

Return whether a required api name matches a pattern specified for an XML <feature> 'api' attribute or <extension> 'supported' attribute. - s

Validate we are generating something only inside a `<feature>` tag

Return a string which is an indented, formatted declaration for a `<param>` or `<member>` block (e.g. function parameter or structure/

Constructor - errFile, warnFile, diagFile - file handles to write errors, warnings, diagnostics to. May be None to not write.

Track aliasing and map back from enum values to their type

Check for an alias in the same require block. - alias - String name of the alias - require - `<require>` block from the registry

boolop :: '+' | ',' extname :: Char(alphas) atom :: extname | '(' expr ')' expr :: atom [ boolop atom ]*

Return an API dependency expression translated to a form suitable for asciidoctor conditionals or header file comments. - dependency - th

Evaluate a dependency expression, returning a boolean result. - dependency - the expression - isSupported - function taking a version or ex

Return the first element that satisfies the predicate, or None if none exist. NOTE: Some places where this is used might be better served by chan

Generate protection preprocessor directive. Protection strings are the strings defining the OS/Platform/Graphics requirements for a given API

Generate a single type / enum group / enum / command, and all its dependencies as needed. - fname - name of feature (`<type>`/`<enum>

Check for an alias in the same require block. - elem - Element to check for an alias

Return C prototype and function pointer typedef for a `<command>` or `type category="funcpointer"` Element, as a two-element list of s

Strip unsupported APIs from attributes of APIs. dictionary - *Info dictionary of APIs to be updated attribute - attribute name t

Return True if the given type 'category' always requires validation. Overridden because Vulkan does not require "valid" text for basetype

Check enumerated values for duplicates. - enums - list of `<enum>` Elements returns the list with duplicates stripped

Evaluate an expression stack, returning an English equivalent - stack - the stack - leafMarkup, opMarkup, parenthesize - same as dependency

Mark up an API version or extension name as a link in the spec.

Generate text showing what core versions and extensions introduce an API. This exists in the base Generator class because it is used by

Get the name associated with an element, either a name child or name attribute.

Get the type associated with an element, either a type child or type attribute.

Get the parent of a handle object.

Get a collection of all member elements for this type, if any.

Get the category of a type.

Return True if this `<enum>` element is required, False otherwise - elem - `<enum>` element to test

Return True if the declaration components (tag,text,tail) of an element represents a void * type. Defaults to a reasonable implementa

Reformat a void * declaration to include the API alias macro. Defaults to a no-op. Must override if you actually want to use this fe

Mark an enum as required or not. - enumname - name of enum - required - boolean (to tag features as required or not)

Require or remove features specified in the Element. - featurename - name of the feature - feature - Element for `<require>` or `<rem

Require (along with its dependencies) or remove (but not its dependencies) a type. - typename - name of type - required - boolean (to

Parse the registry Element, once created

Return True if the require element has no depends attribute, or if the depends boolean expression evaluates to true. Used to exclude r

Remove tree Elements with 'api' attributes matching apiName. tree - Element at the root of the hierarchy to strip. Only its child

Return True if the given type name is always valid (never requires validation). This is for things like integers. Defaults to a reas

Internal-use implementation to make a (comma-separated) list for use in prose. Adds a connective (by default, 'and') before the last

Generate interface for specified versions using the current generator and generator options

Write interface for a feature and tag generated features as having been done. - interface - element for the `<version>` / `<extension>` to ge

Start a new interface file - genOpts - GeneratorOptions controlling what is generated and how

Generate the C declaration for a constant (a single <enum> value). <enum> tags may specify their values in several ways, but are

Generate the C declaration for an enum

Generate the C declaration for an "enum" that is actually a set of flag bits

Generate the C declaration for an enumerated type

Helper function, too long to put in a sort key lambda - feature - FeatureInfo containing the XML element to sort Sorts by:

Return True if self.elem and info.elem have the same definition. info - the other object infoName - 'type' / 'group' / 'enum' / 'comma

A textual description of the compression scheme, or an empty string if it is not compressed

Return dependency expression translated to a form suitable for use in C expressions

Return dependency expression translated to a form suitable for comments in headers of emitted C code, as used by the docgenerator.

Return dependency expression translated to a form suitable for comments in headers of emitted C code, as used by the interfacegenerator.

Return asciidoctor markup for a human-readable equivalent of an API dependency expression, suitable for use in extension appendix metada

Return a set of the extension and version names in an API dependency expression. Used when determining transitive dependencies for spec

Process `<require>` tags for a `<version>` or `<extension>`. - interface - Element for `<version>` or `<extension>`, containing `<r

Finish an interface file, closing it when done. Derived classes responsible for emitting feature

Evaluate an expression stack, returning the set of extension and feature names used in the expression. - stack - the stack

Evaluate an expression stack, returning a boolean result. - stack - the stack - isSupported - function taking a version or extension name s