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

ASDoc @inheritDoc if copies from another @inheritDoc dulicates content

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Open
    • Major
    • Resolution: Unresolved
    • Adobe Flex SDK 4.1 (Release)
    • None
    • ASDoc Tool
    • None
    • Affected OS(s): All OS Platforms
      Affected OS(s): All OS Platforms
      Language Found: English

    Description

      Steps to reproduce:
      1. Create an interface IFoo with a method bar().
      2. Document method bar() in interface.
      3. Implement interface in class Foo.
      4. Document implemented method bar() with @inheritDoc.
      5. Extend class Foo in class FooExtended and override method bar().
      6. Document overridden method bar() with @inheritDoc comment.
      7. Compile documentation.
      8. ???
      9. The documentation for overridden method bar() in class FooExtended is repeated twice!

      Actual Results:
      The documentation is duplicated (sometimes more then once).

      Expected Results:
      The documentation should not repeat if inherited from a superclass.

      Workaround (if any):
      It seems it is possible to work around it with @copyDoc.

      Attachments

        Activity

          People

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

            Dates

              Created:
              Updated: