Commentsutil

this file provides utility classes for parsing and extracting information from comments within code files. it includes methods to identify and extract metadata from both module and non-module comments, facilitating better documentation and understanding of code constructs such as functions, variables, classes, and modules.

moduleName

[variable]

Description: This method extracts module block information from comments, including module name, description, category, subcategory, link, and references.

Params:

Name Description
comments The comments to extract module block information from.

description

[variable]

Description: This method extracts other block information from comments, including description, params, link, examples, returns, thrown errors, and references.

Params:

Name Description
comments The comments to extract other block information from.

fileContent

[variable]

Description: This method retrieves comments from a source file using Acorn parser.

Params:

Name Description
sourceFile The source file to retrieve comments from.

unknown

[other]

Description: This class represents a comment extracted from a source file.

Params:

Name Description
text The text content of the comment.
endLocation The end location of the comment.

unknown

[function]

Description: This method sets the construct information of the comment, including the type and name of the construct.

Params:

Name Description
info The construct information to set.

unknown

[other]

Description: This method retrieves module block information from the comment using the CommentsUtil class.

unknown

[other]

Description: This method retrieves other block information from the comment using the CommentsUtil class.