Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8152397

Documentation ambiguity of support @deprecated tag on package element

    XMLWordPrintable

Details

    Description

      There is an ambiguity in the Javadoc documentation of @deprecated tag:
      http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#deprecated
      This tag is valid in all documentation comments: overview, package, class,
      interface, constructor, method and field.

      http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#CHDBFGCF
      The package tags are the following:

      see reference || @since since-text || @serial field-description | include |
      exclude || @author name-text || @version version-text || {@linkplain
      package.class#member label} || {@linkplain package.class#member label} ||
      {@docRoot} ||

      Is the tag @deprecated supported on package element? If yes, could you please
      repair the part "Package Tags"
      http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#CHDBFGCF which enumerates supported tags of package element?

      Attachments

        Activity

          People

            cwayne Clifford Wayne (Inactive)
            shadowbug Shadow Bug
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: