[FLEX-21257] ASDoc content should be corrected to use properly formatted metadata references in @see tag

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: Adobe Flex SDK Previous
• Component/s: ASDoc Content
• Environment: Affected OS(s): All OS Platforms; Affected OS(s): All OS Platforms; Language Found: English
• Assignee: Adobe JIRA
• Reporter: Adobe JIRA
• Created: 23/Sep/09 16:26
• Updated: 15/Apr/11 15:05
• Resolved: 12/Nov/09 13:14

Description

The public documentation for ASDoc tags has been updated http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_7.html. There is a new example listed for a style metadata reference:

@see mx.containers.DividedBox#style:dividerAffordance

The SDK 4 source does not properly reference metadata properties. For example, see the baseColor declaration in spark.components.supportClasses.SkinnableComponent: "@copy spark.components.supportClasses.GroupBase#baseColor" should be "@copy spark.components.supportClasses.GroupBase#style:baseColor"

The DITA produced carries over the incorrect URI format:

<style format="Color" inherit="yes" name="baseColor" owner="spark.components.supportClasses:SkinnableComponent" playerVersion="Flash10" theme="spark" type="uint">
<description conref="spark.components.supportClasses.GroupBase#baseColor">...

Currently, Flash Builder only processes the "conref" for "apiDesc" DITA tags.