MacroComment

class MacroComment(    signature: MethodCommentSignature,     commentStartLine: Int,     author: List<StacksAuthorTag>,     sees: List<StacksSeeTag>,     description: StacksDescription,     categories: List<StacksCategoryTag>,     aliases: List<StacksAliasTag>,     parameters: List<StacksParameterTag>,     returnsContent: StacksReturnTag,     val exceptions: List<StacksRaisesTag>,     sticky: Boolean) : AvailComment

A comment that describes a particular macro implementation

Author

Richard Arriaga

Parameters

signature

The signature of the macro the comment describes.

commentStartLine

The start line in the module the comment being parsed appears.

author

The author of the implementation.

sees

A List of any "@sees" references.

description

The overall description of the implementation

categories

The categories the implementation appears in

aliases

The aliases the implementation is known by

parameters

The list of parameters of the method implementation.

returnsContent

The "@returns" content

exceptions

A list of any exceptions the method throws.

sticky

Whether or not the method should be documented regardless of visibility

Constructors

Link copied to clipboard
fun MacroComment(    signature: MethodCommentSignature,     commentStartLine: Int,     author: List<StacksAuthorTag>,     sees: List<StacksSeeTag>,     description: StacksDescription,     categories: List<StacksCategoryTag>,     aliases: List<StacksAliasTag>,     parameters: List<StacksParameterTag>,     returnsContent: StacksReturnTag,     exceptions: List<StacksRaisesTag>,     sticky: Boolean)

Construct a new MacroComment.

Functions

Link copied to clipboard
open override fun addImplementationToImportModule(name: A_String, importModule: StacksImportModule)

Add the implementation to the provided StacksImportModule.

Link copied to clipboard
open override fun addToImplementationGroup(commentGroup: CommentGroup)

Add the implementation to the provided group.

Link copied to clipboard
fun identityCheck(): String

Create a string that is unique to this AvailComment.

Link copied to clipboard
open override fun toJSON(    linkingFileMap: LinkingFileMap,     nameOfGroup: String,     errorLog: StacksErrorLog,     jsonWriter: JSONWriter)

Create JSON content from implementation.

Link copied to clipboard
open override fun toString(): String

Properties

Link copied to clipboard
val categorySet: MutableSet<String>

A set of category String names for this implementation.

Link copied to clipboard
val exceptions: List<StacksRaisesTag>

A list of any exceptions the method throws.

Link copied to clipboard
val isSticky: Boolean

Indicates whether or not the comment is sticky