Uploaded image for project: 'Apache Flex'
  1. Apache Flex
  2. FLEX-26666

text before an @copy tag in an ASDoc comment for a style does not appear in the output

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • Adobe Flex SDK Previous
    • None
    • ASDoc Tool
    • None
    • Affected OS(s): All OS Platforms
      Language Found: English

    Description

      If text appears before an @copy tag in an ASDoc comment for a style, the text does not appear, but the @copied text does.

      Here's the relevant portion of the class file:

      /**

      • <i>TLF styles are not supported in the mobile theme.</i>
      • @copy flashx.textLayout.formats.ITextLayoutFormat#lineThrough
      • @langversion 3.0
      • @playerversion Flash 10
      • @playerversion AIR 1.5
      • @productversion Flex 4
        */
        [Style(name="lineThrough", type="Boolean", inherit="yes")]

      It looks like when there's a conref, the description is ignored. Here's the intermediate XML. In this case, the text from the conref attribute appears in the output, but the block inside the description element does not:

      <style inherit="yes" name="lineThrough" owner="spark.components:Image" playerVersion="Flash10" type="Boolean">
      <description conref="flashx.textLayout.formats.ITextLayoutFormat#lineThrough">
      <i>TLF styles are not supported in the mobile theme.</i>
      </description>
      <playerversion>AIR 1.5
      </playerversion>
      <prolog><asCustoms><langversion>3.0
      </langversion><productversion>Flex 4
      </productversion></asCustoms></prolog></style>

      Attachments

        Activity

          People

            adobejira Adobe JIRA
            adobejira Adobe JIRA
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: