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 |
@sends eventRef [ description ] | Documents events that are sent to a channel. eventRef specifies a link to an event definition. The optional description can be anything pertinent to the sending of the event to a channel. 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 the parameter name. The description should be a sentence describing the purpose of the parameter and any constraints on the permitted values that may be specified. | 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 |
@returns description | Documents the return value of an action or aggregate function. The description should be a sentence describing the purpose of the return value, and any pertinent information about the possible values that may be returned. Note that for backwards compatibility reasons @return is maintained as an alias for @returns. | 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 |
@sends eventRef [ description ] | Documents events that are sent. eventRef specifies a link to an event definition. The optional description can be anything pertinent to sending the event. See Inserting ApamaDoc references. | Actions and their return types. |
@since version | Documents when a code construct was introduced. Replace version with a particular version number, for example, 5.3. | 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.3. | Monitor definitions, event type definitions, custom aggregate function definitions, and actions |