17doxygen Module

+----------+  1.. +-----------+  1.. +------+
| document *------| structure *------| elem |
+----------+      +-----------+      +------+

+---------------+  1 +---------+
| configuration *----| aliases |
+---------------+    +---------+

+----------+     +-------------------+
| renderer |<----| specific_renderer |
+----------+     +-------------------+

Reads a Doxygen document from stream and creates an instance of doxygen.document class.

The argument aliases is an instance that is available as a member of doxygen.configuration instance and contains information about command aliases, or custom commands in the other word.

In default, the parser expects the Doxygen document is written within C-style comments and extracts the document body from them before parsing. If the argument extracted is set to true, it exepcts the document already have been extracted from the comments.

If block is specified, it would be evaluated with a block parameter |doc:doxygen.document|, where doc is the created instance. In this case, the block's result would become the function's returned value.

Creates an iterator that returns instances of doxygen.structure contained in the doxygen.document.

In default, this returns an iterator as its result value. Specifying the following attributes would customize the returned value:

• :iter .. An iterator. This is the default behavior.
• :xiter .. An iterator that eliminates nil from its elements.
• :list .. A list.
• :xlist .. A list that eliminates nil from its elements.
• :set .. A list that eliminates duplicated values from its elements.
• :xset .. A list that eliminates duplicated values and nil from its elements.

See the chapter of Mapping Process in Gura Language Manual for the detail.

If a block is specified, it would be evaluated repeatingly with block parameters |value, idx:number| where value is the iterated value and idx the loop index starting from zero. In this case, the last evaluated value of the block would be the result value. If one of the attributes listed above is specified, an iterator or a list of the evaluated value would be returned.

Creates an iterator that returns doxygen.elem instances of all the elements contained in the structure.

In default, this returns an iterator as its result value. Specifying the following attributes would customize the returned value:

• :iter .. An iterator. This is the default behavior.
• :xiter .. An iterator that eliminates nil from its elements.
• :list .. A list.
• :xlist .. A list that eliminates nil from its elements.
• :set .. A list that eliminates duplicated values from its elements.
• :xset .. A list that eliminates duplicated values and nil from its elements.

See the chapter of Mapping Process in Gura Language Manual for the detail.

If a block is specified, it would be evaluated repeatingly with block parameters |value, idx:number| where value is the iterated value and idx the loop index starting from zero. In this case, the last evaluated value of the block would be the result value. If one of the attributes listed above is specified, an iterator or a list of the evaluated value would be returned.

Creates an iterator that returns doxygen.structure instances of sub structures contained in the structure.

In default, this returns an iterator as its result value. Specifying the following attributes would customize the returned value:

• :iter .. An iterator. This is the default behavior.
• :xiter .. An iterator that eliminates nil from its elements.
• :list .. A list.
• :xlist .. A list that eliminates nil from its elements.
• :set .. A list that eliminates duplicated values from its elements.
• :xset .. A list that eliminates duplicated values and nil from its elements.

See the chapter of Mapping Process in Gura Language Manual for the detail.

If a block is specified, it would be evaluated repeatingly with block parameters |value, idx:number| where value is the iterated value and idx the loop index starting from zero. In this case, the last evaluated value of the block would be the result value. If one of the attributes listed above is specified, an iterator or a list of the evaluated value would be returned.

Prints out the content of the element to out with an indentation level specified by indent that starts from zero. If out is omitted, the result would be put out to standard output.

Renders the element content using doxygen.renderer.

Reads a configuration file, which is usually dubbed "Doxyfile", from stream and creates a doxygen.configuration instance.

If block is specified, it would be evaluated with a block parameter |cfg:doxygen.configuration|, where cfg is the created instance. In this case, the block's result would become the function's returned value.

Returns a value associated with the tag specified by the argument tagname.

If the specified tag is not found, the method would return nil while it would cause an error in the case the attribute :raise is specified.

Prints out the content of the configuration to out. If omitted, the result would be put out to standard output.

Prints out definitions of aliases to the stream out. If the argument is omitted, the result would be put out to the standard output.

Creates a doxygen.renderer instance.

If block is specified, it would be evaluated with a block parameter |renderer:doxygen.renderer|, where renderer is the created instance. In this case, the block's result would become the function's returned value.