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

javac should no longer treat @deprecated javadoc tag as indicating formal deprecation

    XMLWordPrintable

Details

    • Enhancement
    • Status: Open
    • P4
    • Resolution: Unresolved
    • 9
    • tbd
    • tools
    • None

    Description

      Prior to Java SE 5.0, deprecation was formally indicated using the "@deprecated" javadoc tag. Java SE 5.0 instead defined the java.lang.Deprecated annotation type for that purpose, with the @deprecated tag being retained to provide helpful suggestions on what to do instead of using the deprecated API.

      However, javac has continued to treat the @deprecated javadoc tag as indicating deprecation and issues the same warning messages as if @Deprecated were used.

      At least for source levels of 9 and above, I'd recommend javac

      1) Stop treating @deprecated as an indication of deprecation
      2) Issue a warning message if @deprecated is used on a declaration that is not also @Deprecated

      Attachments

        Issue Links

          Activity

            People

              jjg Jonathan Gibbons
              darcy Joe Darcy
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated: