Developing Apama Applications > Developing Apama Applications in EPL > Generating Documentation for Your EPL Code > Inserting ApamaDoc references
Inserting ApamaDoc references
Many ApamaDoc tags contain links to other parts of the EPL code. These tags specify one of the following link types:
*Code references
*Type references
*Event references
*Action references
A code reference is a link to a monitor definition, an event type definition, an action definition, a member (variable or named constant) declaration or an import declaration. A code reference has two forms.
The first form links to constructs that are in the monitor definition or event type definition that contains this ApamaDoc comment. The target of the link can be a variable declaration, named constant declaration, import declaration, or action definition. The format for this code reference is as follows:
[ # ] (member | import | ( action() ) )
The hash symbol is optional. You must specify one of the following:
*Name of a member (variable or named constant) that is in the monitor or event type definition that contains this ApamaDoc comment.
*Name of an item that is being imported in the monitor or event type definition that contains this ApamaDoc comment.
*Name of an action that is in the monitor that contains this ApamaDoc comment. If you specify an action, the name of the action must end with parentheses. For example:
#updateOrder()
The second form links to constructs that are not in the monitor or event type definition that contains this ApamaDoc comment. You can link to code constructs that are in the same package or in other packages. The format for this code reference is as follows:
[ package [. monitor ].]type[ #(member | import | ( action() ) )]
Replace type with the name of a monitor or event type definition. If the ApamaDoc comment is in the same package as the link target, the package specification is optional. If you replaced type with the name of an event that is defined in a monitor, you must replace monitor with the name of that monitor and you must specify the package name.
The hash symbol followed by a name is required when the link target is a variable declaration, named constant declaration, import declaration, or action definition. If you specify an action, the name of the action must end with parentheses.
If the code reference is valid the rendered HTML output contains a hyperlink to the referenced code construct's documentation followed by the descriptions text, if any. If the reference is not valid, the output displays only the tag’s description text if you provided it.
A type reference is a subset of a code reference. It always links to a monitor or event type definition.
An event reference is a subset of a type reference. It always links to an event type definition.
An action reference is a subset of code reference. It always links to an action. The action can be in an event type definition, in a monitor, or in an event type definition that is in a monitor.
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.