Adobe Flex 3 Help

Using the @see tag

The @see tag lets you create cross-references to elements within a class; to elements in other classes in the same package; and to other packages. You can also cross-reference URLs outside of ASDoc. The @see tag has the following syntax:

@see reference [displayText]

where reference specifies the destination of the link, and displayText optionally specifies the link text. The location of the destination of the @see tag is determined by the prefix to the reference attribute:

  • # ASDoc looks in the same class for the link destination.
  • ClassName ASDoc looks in a class in the same package for the link destination.
  • PackageName ASDoc looks in a different package for the link destination.
  • global ASDoc looks in the Top Level package for the link destination.
  • style ASDoc looks for a style property for the link destination.

Note: You cannot insert HTML tags in reference. However, you can add an HTML link without using the @see tag by inserting the HTML code in the ASDoc comment.

The following table shows several examples of the @see tag:

Example

Result
@see "Just a label"

Text string
@see http://www.cnn.com

External website
@see package-detail.html

Local HTML file
@see Array

Top-level class
@see AccessibilityProperties

Class in same package
@see flash.display.TextField

Class in different package
@see Array#length

Property in top level class
@see flash.ui.ContextMenu#customItems

Property in class in different package
@see mx.containers.DividedBox#style:dividerAffordance

Style property in class in different package
@see #updateProperties()

Method in same class as @see tag
@see Array#pop()

Method in top-level class
@see flash.ui.ContextMenu#clone()

Method in class in different package
@see global#Boolean()

Package method in Top Level (global)
@see flash.util.#clearInterval()

Package method in flash.util