Developing Apama Applications > Developing Apama Applications in EPL > Generating Documentation for Your EPL Code > Inserting ApamaDoc tags
Inserting ApamaDoc tags
ApamaDoc automatically generates documentation for EPL code constructs. To enhance the quality of the documentation, you can insert tags that let you provide and link to additional information. A tag begins with an @ symbol and is immediately followed by a name and other information. The following table describes the tags you can insert.
Tag
Description
Use For
@author name
There are no restrictions on the name. It can span multiple lines. It is ended by the start of the next tag.
Imports, events, monitors, aggregate functions
@deprecated [ description]
The optional description can be anything pertinent to the deprecated construct. For example, you might want to suggest a newer equivalent or provide a reason for the deprecation.
Imports, events, monitors, actions, and members (variables and named constants)
@emits eventRef [ description ]
Documents events that are emitted. eventRef specifies a link to an event definition. The optional description can be anything pertinent to the emitting of the event. See Inserting ApamaDoc references.
Actions and their return types
@enqueues eventRef [ description ]
Documents events that are enqueued. eventRef specifies a link to an event definition. The optional description can be anything pertinent to the enqueueing of the event. See Inserting ApamaDoc references.
Actions and their return types
@listens eventRef [ description ]
Dccuments events that are being listened for. eventRef specifies a link to an event definition. The optional description can be anything pertinent to the event listener. See Inserting ApamaDoc references.
Actions and their return types
@param codeRef [ description ]
Documents arguments to actions and custom aggregate functions. codeRef specifies a link to a variable. The optional description can be anything pertinent to the parameter. See Inserting ApamaDoc references.
Actions and custom aggregate functions
@private
Hides constructs from ApamaDoc. On a line by itself, immediately precede the construct that you do not want to generate documentation for with the following:
/** @private /*
All code constructs except packages and action contents
@return codeRef [ description ]
Documents return values from actions and aggregate functions. codeRef specifies a link to a variable. The optional description can be anything pertinent to the return value.
Actions and aggregate functions
@routes eventRef [ description ]
Documents events that are being routed. eventRef specifies a link to an event definition. The optional description can be anything pertinent to the routing of the event. See Inserting ApamaDoc references.
Actions and their return types
@see
There are three forms of this tag. Each form documents a relationship between a code fragment and some other information.
@see "description"
Lets you insert text that explains the relationship.
@see codeRef description
Lets you reference an EPL code construct and describe the relationship between this construct and that construct. codeRef specifies a link to some other EPL code. See Inserting ApamaDoc references.
@see <a href="url">linkText</a> [description]
Lets you specify an HTML link to an external resource. Optionally, you can add more information.
All code constructs except packages and action contents
@since version
Documents when a code construct was introduced. Replace version with a particular version number, for example, 5.1.
All code constructs except packages and action contents
@spawns actionRef [ description ]
Lets you document the lifecycle of a monitor. actionRef specifies a link to an action definition. See Inserting ApamaDoc references.
Monitors and actions
@version version
Lets you specify a version of the current incarnation of this code. Replace version with a particular version number, for example, 5.1.
Monitor definitions, event type definitions, custom aggregate function definitions, and actions
Copyright © 2013 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.