ASDoc tags 文档注释标签详解

转至Adobe:http://livedocs.adobe.com/flex/3/html/index.html?content=asdoc_9.html

ASDoc tag	Description	Example
`@copy reference`	Copies an ASDoc comment from the referenced location. The main description, `@param`, and `@return` content is copied; other tags are not copied. You typically use the `@copy` tag to copy information from a source class or interface not in the inheritance list of the destination class. If the source class or interface is in the inheritance list, use the `@inheritDoc` tag instead. You can add content to the ASDoc comment before the `@copy` tag. Specify the location by using the same syntax as you do for the `@see` tag. For more information, see Using the @see tag.	`@copy #stop` `@copy MovieClip#stop`
`@default value`	Specifies the default value for a property, style, or effect. The ASDoc tool automatically creates a sentence in the following form when it encounters an `@default` tag: `The default value is value.`	`@default 0xCCCCCC`
`@eventType package.class.CONSTANT` `@eventType String`	Use the first form in a comment for an `[Event]` metadata tag. It specifies the constant that defines the value of the `Event.type` property of the event object associated with the event. The ASDoc tool copies the description of the event constant to the referencing class. Use the second form in the comment for the constant definition. It specifies the name of the event associated with the constant. If the tag is omitted, ASDoc cannot copy the constant's comment to a referencing class.	See Documenting effects, events, and styles
`@example exampleText`	Applies style properties, generates a heading, and puts the code example in the correct location. Enclose the code in `<listing version="3.0"></listing>` tags. Whitespace formatting is preserved and the code is displayed in a gray, horizontally scrolling box.	`@example The following code sets the volume level for your sound:` `<listing version="3.0">` `var mySound:Sound = new Sound(); mySound.setVolume(VOL_HIGH);` `</listing>`
`@exampleText string`	Use this tag in an ASDoc comment in an external example file that is referenced by the `@example` tag. The ASDoc comment must precede the first line of the example, or follow the last line of the example. External example files support one comment before and one comment after example code.	`/*` ` This text does not appear` `* in the output.` `* @exampleText But this does.` `*/`
`@inheritDoc`	Use this tag in the comment of an overridden method or property. It copies the comment from the superclass into the subclass, or from an interface implemented by the subclass. The main ASDoc comment, `@param`, and `@return` content are copied; other tags are not. You can add content to the comment before the `@inheritDoc` tag. When you include this tag, ASdoc uses the following search order: 1. Interfaces implemented by the current class (in no particular order) and all of their base-interfaces. 2. Immediate superclass of current class. 3. Interfaces of immediate superclass and all of their base-interfaces. 4. Repeat steps 2 and 3 until the Object class is reached. You can also use the `@copy` tag, but the `@copy` tag is for copying information from a source class or interface that is not in the inheritance chain of the subclass.	`@inheritDoc`
`@internal text`	Hides the text attached to the tag in the generated output. The hidden text can be used for internal comments.	`@internal Please do not publicize the undocumented use of the third parameter in this method.`
`@param paramName description`	Adds a descriptive comment to a method parameter. The `paramName` argument must match a parameter definition in the method signature.	`@param fileName The name of the file to load.`
`@private`	Exclude the element from the generated output. To omit an entire class, put the `@private` tag in the ASDoc comment for the class; to omit a single class element, put the `@private` tag in the ASDoc comment for the element.	`@private`
`@return description`	Adds a Returns section to a method description with the specified text. ASDoc automatically determines the data type of the return value.	`@return The translated message.`
`@see reference [displayText]`	Adds a See Also heading with a link to a class element. For more information, see Using the @see tag. Do not include HTML formatting characters in the arguments to the `@see` tag.	`@see flash.display.MovieClip`
`@throws package.class.className description`	Documents an error that a method can throw.	`@throws SecurityError Local untrusted SWFs may not communicate with the Internet.`